@milaboratories/pl-client 2.18.5 → 3.1.0

package/dist/test/test_config.cjs

@@ -1,20 +1,19 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-const require_types = require('../core/types.cjs');
-const require_config = require('../core/config.cjs');
-const require_auth = require('../core/auth.cjs');
-const require_ll_client = require('../core/ll_client.cjs');
-const require_client = require('../core/client.cjs');
-const require_unauth_client = require('../core/unauth_client.cjs');
-const require_tcp_proxy = require('./tcp-proxy.cjs');
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_types = require("../core/types.cjs");
+const require_config = require("../core/config.cjs");
+const require_auth = require("../core/auth.cjs");
+const require_ll_client = require("../core/ll_client.cjs");
+const require_client = require("../core/client.cjs");
+const require_unauth_client = require("../core/unauth_client.cjs");
+const require_tcp_proxy = require("./tcp-proxy.cjs");
 let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
 node_fs = require_runtime.__toESM(node_fs);
 let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path);
-
 //#region src/test/test_config.ts
 var test_config_exports = /* @__PURE__ */ require_runtime.__exportAll({
-	TEST_REQUEST_TIMEOUT: () => TEST_REQUEST_TIMEOUT,
+	TEST_REQUEST_TIMEOUT: () => 500,
 	getTestClient: () => getTestClient,
 	getTestClientConf: () => getTestClientConf,
 	getTestConfig: () => getTestConfig,
@@ -38,12 +37,10 @@ function getTestConfig() {
 	if (conf.address === void 0) throw new Error(`can't resolve platform address (checked ${CONFIG_FILE} file and PL_ADDRESS environment var)`);
 	return conf;
 }
-/** Default request timeout for tests (ms) */
-const TEST_REQUEST_TIMEOUT = 500;
 /** Returns PlClientConfig with reduced timeout for tests */
 function plAddressToTestConfig(address) {
 	const plConf = require_config.plAddressToConfig(address);
-	plConf.defaultRequestTimeout = TEST_REQUEST_TIMEOUT;
+	plConf.defaultRequestTimeout = 500;
 	return plConf;
 }
 function saveAuthInfoCallback(tConf) {
@@ -159,12 +156,12 @@ async function withTempRoot(body, options = {}) {
 		}
 	}
 }
-
 //#endregion
-Object.defineProperty(exports, 'test_config_exports', {
-  enumerable: true,
-  get: function () {
-    return test_config_exports;
-  }
+Object.defineProperty(exports, "test_config_exports", {
+	enumerable: true,
+	get: function() {
+		return test_config_exports;
+	}
 });
+
 //# sourceMappingURL=test_config.cjs.map

package/dist/test/test_config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"test_config.cjs","names":["path","fs","plAddressToConfig","inferAuthRefreshTime","UnauthenticatedPlClient","LLPlClient","PlClient","NullResourceId","startTcpProxy","resourceIdToString"],"sources":["../../src/test/test_config.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport { LLPlClient } from \"../core/ll_client\";\nimport type { AuthInformation, AuthOps, PlClientConfig } from \"../core/config\";\nimport { plAddressToConfig } from \"../core/config\";\nimport { UnauthenticatedPlClient } from \"../core/unauth_client\";\nimport { PlClient } from \"../core/client\";\nimport { randomUUID } from \"node:crypto\";\nimport type { OptionalResourceId } from \"../core/types\";\nimport { NullResourceId, resourceIdToString } from \"../core/types\";\nimport { inferAuthRefreshTime } from \"../core/auth\";\nimport * as path from \"node:path\";\nimport type { TestTcpProxy } from \"./tcp-proxy\";\nimport { startTcpProxy } from \"./tcp-proxy\";\n\nexport { TestTcpProxy };\n\nexport interface TestConfig {\n  address: string;\n  test_proxy?: string;\n  test_user?: string;\n  test_password?: string;\n}\n\nconst CONFIG_FILE = \"test_config.json\";\n// const AUTH_DATA_FILE = '.test_auth.json';\n\nlet authDataFilePath: string | undefined;\n\nfunction getFullAuthDataFilePath() {\n  if (authDataFilePath === undefined) authDataFilePath = path.resolve(\".test_auth.json\");\n  return authDataFilePath;\n}\n\nexport function getTestConfig(): TestConfig {\n  let conf: Partial<TestConfig> = {};\n  if (fs.existsSync(CONFIG_FILE))\n    conf = JSON.parse(fs.readFileSync(CONFIG_FILE, { encoding: \"utf-8\" })) as TestConfig;\n\n  if (process.env.PL_ADDRESS !== undefined) conf.address = process.env.PL_ADDRESS;\n\n  if (process.env.PL_TEST_USER !== undefined) conf.test_user = process.env.PL_TEST_USER;\n\n  if (process.env.PL_TEST_PASSWORD !== undefined) conf.test_password = process.env.PL_TEST_PASSWORD;\n\n  if (process.env.PL_TEST_PROXY !== undefined) conf.test_proxy = process.env.PL_TEST_PROXY;\n\n  if (conf.address === undefined)\n    throw new Error(\n      `can't resolve platform address (checked ${CONFIG_FILE} file and PL_ADDRESS environment var)`,\n    );\n\n  return conf as TestConfig;\n}\n\n/** Default request timeout for tests (ms) */\nexport const TEST_REQUEST_TIMEOUT = 500;\n\n/** Returns PlClientConfig with reduced timeout for tests */\nexport function plAddressToTestConfig(address: string): PlClientConfig {\n  const plConf = plAddressToConfig(address);\n  plConf.defaultRequestTimeout = TEST_REQUEST_TIMEOUT;\n  return plConf;\n}\n\ninterface AuthCache {\n  /** To check if config changed */\n  conf: TestConfig;\n  expiration: number;\n  authInformation: AuthInformation;\n}\n\nfunction saveAuthInfoCallback(tConf: TestConfig): (authInformation: AuthInformation) => void {\n  return (authInformation) => {\n    const dst = getFullAuthDataFilePath();\n    const tmpDst = getFullAuthDataFilePath() + randomUUID();\n    fs.writeFileSync(\n      tmpDst,\n      Buffer.from(\n        JSON.stringify({\n          conf: tConf,\n          authInformation,\n          expiration: inferAuthRefreshTime(authInformation, 24 * 60 * 60),\n        } as AuthCache),\n      ),\n      \"utf8\",\n    );\n    fs.renameSync(tmpDst, dst);\n  };\n}\n\nconst cleanAuthInfoCallback = () => {\n  console.warn(`Removing: ${getFullAuthDataFilePath()}`);\n  fs.rmSync(getFullAuthDataFilePath());\n};\n\nexport async function getTestClientConf(): Promise<{ conf: PlClientConfig; auth: AuthOps }> {\n  const tConf = getTestConfig();\n\n  let authInformation: AuthInformation | undefined = undefined;\n\n  // try recover from cache\n  if (fs.existsSync(getFullAuthDataFilePath())) {\n    try {\n      const cache: AuthCache = JSON.parse(\n        fs.readFileSync(getFullAuthDataFilePath(), { encoding: \"utf-8\" }),\n      ) as AuthCache; // TODO runtime validation\n      if (\n        cache.conf.address === tConf.address &&\n        cache.conf.test_user === tConf.test_user &&\n        cache.conf.test_password === tConf.test_password &&\n        cache.expiration > Date.now()\n      )\n        authInformation = cache.authInformation;\n    } catch {\n      // removing cache file on any error\n      fs.rmSync(getFullAuthDataFilePath());\n    }\n  }\n\n  const plConf = plAddressToTestConfig(tConf.address);\n  const uClient = await UnauthenticatedPlClient.build(plConf);\n\n  const requireAuth = await uClient.requireAuth();\n\n  if (!requireAuth && (tConf.test_user !== undefined || tConf.test_password !== undefined))\n    throw new Error(\n      `Server require no auth, but test user name or test password are provided via (${CONFIG_FILE}) or env variables: PL_TEST_USER and PL_TEST_PASSWORD`,\n    );\n\n  if (requireAuth && (tConf.test_user === undefined || tConf.test_password === undefined))\n    throw new Error(\n      `No auth information found in config (${CONFIG_FILE}) or env variables: PL_TEST_USER and PL_TEST_PASSWORD`,\n    );\n\n  if (authInformation === undefined) {\n    if (requireAuth) authInformation = await uClient.login(tConf.test_user!, tConf.test_password!);\n    // No authorization is required\n    else authInformation = {};\n\n    // saving cache\n    saveAuthInfoCallback(tConf)(authInformation);\n  }\n\n  return {\n    conf: plConf,\n    auth: {\n      authInformation,\n      onUpdate: saveAuthInfoCallback(tConf),\n      onAuthError: cleanAuthInfoCallback,\n      onUpdateError: cleanAuthInfoCallback,\n    },\n  };\n}\n\nexport async function getTestLLClient(confOverrides: Partial<PlClientConfig> = {}) {\n  const { conf, auth } = await getTestClientConf();\n  return await LLPlClient.build({ ...conf, ...confOverrides }, { auth });\n}\n\nexport async function getTestClient(\n  alternativeRoot?: string,\n  confOverrides: Partial<PlClientConfig> = {},\n) {\n  const { conf, auth } = await getTestClientConf();\n  if (alternativeRoot !== undefined && conf.alternativeRoot !== undefined)\n    throw new Error(\"test pl address configured with alternative root\");\n  return await PlClient.init({ ...conf, ...confOverrides, alternativeRoot }, auth);\n}\n\nexport type WithTempRootOptions =\n  | {\n      /** If true and PL_ADDRESS is http://localhost or http://127.0.0.1:<port>,\n       * a TCP proxy will be started and PL client will connect through it. */\n      viaTcpProxy: true;\n      /** Artificial latency for proxy (ms). Default 0 */\n      proxyLatencyMs?: number;\n    }\n  | {\n      viaTcpProxy?: undefined;\n    };\n\nexport async function withTempRoot<T>(body: (pl: PlClient) => Promise<T>): Promise<T | void>;\n\nexport async function withTempRoot<T>(\n  body: (pl: PlClient, proxy: Awaited<ReturnType<typeof startTcpProxy>>) => Promise<T>,\n  options: {\n    viaTcpProxy: true;\n    proxyLatencyMs?: number;\n  },\n): Promise<T>;\n\nexport async function withTempRoot<T>(\n  body: (pl: PlClient, proxy: any) => Promise<T>,\n  options: WithTempRootOptions = {},\n): Promise<T | undefined> {\n  const alternativeRoot = `test_${Date.now()}_${randomUUID()}`;\n  let altRootId: OptionalResourceId = NullResourceId;\n  // Proxy management\n  let proxy: Awaited<ReturnType<typeof startTcpProxy>> | undefined;\n  let confOverrides: Partial<PlClientConfig> = {};\n  try {\n    // Optionally start TCP proxy and rewrite PL_ADDRESS to point to proxy\n    if (options.viaTcpProxy === true && process.env.PL_ADDRESS) {\n      try {\n        const url = new URL(process.env.PL_ADDRESS);\n        const isHttp = url.protocol === \"http:\";\n        const isLocal = url.hostname === \"127.0.0.1\" || url.hostname === \"localhost\";\n        const port = parseInt(url.port);\n        if (isHttp && isLocal && Number.isFinite(port)) {\n          proxy = await startTcpProxy({ targetPort: port, latency: options.proxyLatencyMs ?? 0 });\n          // Override client connection host:port to proxy\n          confOverrides = { hostAndPort: `127.0.0.1:${proxy.port}` } as Partial<PlClientConfig>;\n        } else {\n          console.warn(\n            \"*** skipping proxy-based test, PL_ADDRESS is not localhost\",\n            process.env.PL_ADDRESS,\n          );\n          return;\n        }\n      } catch {\n        // ignore proxy setup errors; tests will run against original address\n      }\n    }\n\n    const client = await getTestClient(alternativeRoot, confOverrides);\n    altRootId = client.clientRoot;\n    try {\n      const value = await body(client, proxy);\n      const rawClient = await getTestClient();\n      try {\n        await rawClient.deleteAlternativeRoot(alternativeRoot);\n      } catch (cleanupErr: any) {\n        // Cleanup may fail if test intentionally deleted resources\n        console.warn(`Failed to clean up alternative root ${alternativeRoot}:`, cleanupErr.message);\n      } finally {\n        // Close the cleanup client to avoid dangling gRPC channels that can cause\n        // segfaults during process exit\n        await rawClient.close();\n      }\n      return value;\n    } finally {\n      // Close the test client to avoid dangling gRPC channels\n      await client.close();\n    }\n  } catch (err: any) {\n    console.log(`ALTERNATIVE ROOT: ${alternativeRoot} (${resourceIdToString(altRootId)})`);\n    throw err;\n    // throw new Error('withTempRoot error: ' + err.message, { cause: err });\n  } finally {\n    // Stop proxy if started\n    if (proxy) {\n      try {\n        await proxy.disconnectAll();\n      } catch {\n        /* ignore */\n      }\n      try {\n        await new Promise<void>((resolve) => proxy!.server.close(() => resolve()));\n      } catch {\n        /* ignore */\n      }\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"test_config.cjs","names":["path","fs","plAddressToConfig","inferAuthRefreshTime","UnauthenticatedPlClient","LLPlClient","PlClient","NullResourceId","startTcpProxy","resourceIdToString"],"sources":["../../src/test/test_config.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport { LLPlClient } from \"../core/ll_client\";\nimport type { AuthInformation, AuthOps, PlClientConfig } from \"../core/config\";\nimport { plAddressToConfig } from \"../core/config\";\nimport { UnauthenticatedPlClient } from \"../core/unauth_client\";\nimport { PlClient } from \"../core/client\";\nimport { randomUUID } from \"node:crypto\";\nimport type { OptionalResourceId } from \"../core/types\";\nimport { NullResourceId, resourceIdToString } from \"../core/types\";\nimport { inferAuthRefreshTime } from \"../core/auth\";\nimport * as path from \"node:path\";\nimport type { TestTcpProxy } from \"./tcp-proxy\";\nimport { startTcpProxy } from \"./tcp-proxy\";\n\nexport { TestTcpProxy };\n\nexport interface TestConfig {\n  address: string;\n  test_proxy?: string;\n  test_user?: string;\n  test_password?: string;\n}\n\nconst CONFIG_FILE = \"test_config.json\";\n// const AUTH_DATA_FILE = '.test_auth.json';\n\nlet authDataFilePath: string | undefined;\n\nfunction getFullAuthDataFilePath() {\n  if (authDataFilePath === undefined) authDataFilePath = path.resolve(\".test_auth.json\");\n  return authDataFilePath;\n}\n\nexport function getTestConfig(): TestConfig {\n  let conf: Partial<TestConfig> = {};\n  if (fs.existsSync(CONFIG_FILE))\n    conf = JSON.parse(fs.readFileSync(CONFIG_FILE, { encoding: \"utf-8\" })) as TestConfig;\n\n  if (process.env.PL_ADDRESS !== undefined) conf.address = process.env.PL_ADDRESS;\n\n  if (process.env.PL_TEST_USER !== undefined) conf.test_user = process.env.PL_TEST_USER;\n\n  if (process.env.PL_TEST_PASSWORD !== undefined) conf.test_password = process.env.PL_TEST_PASSWORD;\n\n  if (process.env.PL_TEST_PROXY !== undefined) conf.test_proxy = process.env.PL_TEST_PROXY;\n\n  if (conf.address === undefined)\n    throw new Error(\n      `can't resolve platform address (checked ${CONFIG_FILE} file and PL_ADDRESS environment var)`,\n    );\n\n  return conf as TestConfig;\n}\n\n/** Default request timeout for tests (ms) */\nexport const TEST_REQUEST_TIMEOUT = 500;\n\n/** Returns PlClientConfig with reduced timeout for tests */\nexport function plAddressToTestConfig(address: string): PlClientConfig {\n  const plConf = plAddressToConfig(address);\n  plConf.defaultRequestTimeout = TEST_REQUEST_TIMEOUT;\n  return plConf;\n}\n\ninterface AuthCache {\n  /** To check if config changed */\n  conf: TestConfig;\n  expiration: number;\n  authInformation: AuthInformation;\n}\n\nfunction saveAuthInfoCallback(tConf: TestConfig): (authInformation: AuthInformation) => void {\n  return (authInformation) => {\n    const dst = getFullAuthDataFilePath();\n    const tmpDst = getFullAuthDataFilePath() + randomUUID();\n    fs.writeFileSync(\n      tmpDst,\n      Buffer.from(\n        JSON.stringify({\n          conf: tConf,\n          authInformation,\n          expiration: inferAuthRefreshTime(authInformation, 24 * 60 * 60),\n        } as AuthCache),\n      ),\n      \"utf8\",\n    );\n    fs.renameSync(tmpDst, dst);\n  };\n}\n\nconst cleanAuthInfoCallback = () => {\n  console.warn(`Removing: ${getFullAuthDataFilePath()}`);\n  fs.rmSync(getFullAuthDataFilePath());\n};\n\nexport async function getTestClientConf(): Promise<{ conf: PlClientConfig; auth: AuthOps }> {\n  const tConf = getTestConfig();\n\n  let authInformation: AuthInformation | undefined = undefined;\n\n  // try recover from cache\n  if (fs.existsSync(getFullAuthDataFilePath())) {\n    try {\n      const cache: AuthCache = JSON.parse(\n        fs.readFileSync(getFullAuthDataFilePath(), { encoding: \"utf-8\" }),\n      ) as AuthCache; // TODO runtime validation\n      if (\n        cache.conf.address === tConf.address &&\n        cache.conf.test_user === tConf.test_user &&\n        cache.conf.test_password === tConf.test_password &&\n        cache.expiration > Date.now()\n      )\n        authInformation = cache.authInformation;\n    } catch {\n      // removing cache file on any error\n      fs.rmSync(getFullAuthDataFilePath());\n    }\n  }\n\n  const plConf = plAddressToTestConfig(tConf.address);\n  const uClient = await UnauthenticatedPlClient.build(plConf);\n\n  const requireAuth = await uClient.requireAuth();\n\n  if (!requireAuth && (tConf.test_user !== undefined || tConf.test_password !== undefined))\n    throw new Error(\n      `Server require no auth, but test user name or test password are provided via (${CONFIG_FILE}) or env variables: PL_TEST_USER and PL_TEST_PASSWORD`,\n    );\n\n  if (requireAuth && (tConf.test_user === undefined || tConf.test_password === undefined))\n    throw new Error(\n      `No auth information found in config (${CONFIG_FILE}) or env variables: PL_TEST_USER and PL_TEST_PASSWORD`,\n    );\n\n  if (authInformation === undefined) {\n    if (requireAuth) authInformation = await uClient.login(tConf.test_user!, tConf.test_password!);\n    // No authorization is required\n    else authInformation = {};\n\n    // saving cache\n    saveAuthInfoCallback(tConf)(authInformation);\n  }\n\n  return {\n    conf: plConf,\n    auth: {\n      authInformation,\n      onUpdate: saveAuthInfoCallback(tConf),\n      onAuthError: cleanAuthInfoCallback,\n      onUpdateError: cleanAuthInfoCallback,\n    },\n  };\n}\n\nexport async function getTestLLClient(confOverrides: Partial<PlClientConfig> = {}) {\n  const { conf, auth } = await getTestClientConf();\n  return await LLPlClient.build({ ...conf, ...confOverrides }, { auth });\n}\n\nexport async function getTestClient(\n  alternativeRoot?: string,\n  confOverrides: Partial<PlClientConfig> = {},\n) {\n  const { conf, auth } = await getTestClientConf();\n  if (alternativeRoot !== undefined && conf.alternativeRoot !== undefined)\n    throw new Error(\"test pl address configured with alternative root\");\n  return await PlClient.init({ ...conf, ...confOverrides, alternativeRoot }, auth);\n}\n\nexport type WithTempRootOptions =\n  | {\n      /** If true and PL_ADDRESS is http://localhost or http://127.0.0.1:<port>,\n       * a TCP proxy will be started and PL client will connect through it. */\n      viaTcpProxy: true;\n      /** Artificial latency for proxy (ms). Default 0 */\n      proxyLatencyMs?: number;\n    }\n  | {\n      viaTcpProxy?: undefined;\n    };\n\nexport async function withTempRoot<T>(body: (pl: PlClient) => Promise<T>): Promise<T | void>;\n\nexport async function withTempRoot<T>(\n  body: (pl: PlClient, proxy: Awaited<ReturnType<typeof startTcpProxy>>) => Promise<T>,\n  options: {\n    viaTcpProxy: true;\n    proxyLatencyMs?: number;\n  },\n): Promise<T>;\n\nexport async function withTempRoot<T>(\n  body: (pl: PlClient, proxy: any) => Promise<T>,\n  options: WithTempRootOptions = {},\n): Promise<T | undefined> {\n  const alternativeRoot = `test_${Date.now()}_${randomUUID()}`;\n  let altRootId: OptionalResourceId = NullResourceId;\n  // Proxy management\n  let proxy: Awaited<ReturnType<typeof startTcpProxy>> | undefined;\n  let confOverrides: Partial<PlClientConfig> = {};\n  try {\n    // Optionally start TCP proxy and rewrite PL_ADDRESS to point to proxy\n    if (options.viaTcpProxy === true && process.env.PL_ADDRESS) {\n      try {\n        const url = new URL(process.env.PL_ADDRESS);\n        const isHttp = url.protocol === \"http:\";\n        const isLocal = url.hostname === \"127.0.0.1\" || url.hostname === \"localhost\";\n        const port = parseInt(url.port);\n        if (isHttp && isLocal && Number.isFinite(port)) {\n          proxy = await startTcpProxy({ targetPort: port, latency: options.proxyLatencyMs ?? 0 });\n          // Override client connection host:port to proxy\n          confOverrides = { hostAndPort: `127.0.0.1:${proxy.port}` } as Partial<PlClientConfig>;\n        } else {\n          console.warn(\n            \"*** skipping proxy-based test, PL_ADDRESS is not localhost\",\n            process.env.PL_ADDRESS,\n          );\n          return;\n        }\n      } catch {\n        // ignore proxy setup errors; tests will run against original address\n      }\n    }\n\n    const client = await getTestClient(alternativeRoot, confOverrides);\n    altRootId = client.clientRoot;\n    try {\n      const value = await body(client, proxy);\n      const rawClient = await getTestClient();\n      try {\n        await rawClient.deleteAlternativeRoot(alternativeRoot);\n      } catch (cleanupErr: any) {\n        // Cleanup may fail if test intentionally deleted resources\n        console.warn(`Failed to clean up alternative root ${alternativeRoot}:`, cleanupErr.message);\n      } finally {\n        // Close the cleanup client to avoid dangling gRPC channels that can cause\n        // segfaults during process exit\n        await rawClient.close();\n      }\n      return value;\n    } finally {\n      // Close the test client to avoid dangling gRPC channels\n      await client.close();\n    }\n  } catch (err: any) {\n    console.log(`ALTERNATIVE ROOT: ${alternativeRoot} (${resourceIdToString(altRootId)})`);\n    throw err;\n    // throw new Error('withTempRoot error: ' + err.message, { cause: err });\n  } finally {\n    // Stop proxy if started\n    if (proxy) {\n      try {\n        await proxy.disconnectAll();\n      } catch {\n        /* ignore */\n      }\n      try {\n        await new Promise<void>((resolve) => proxy!.server.close(() => resolve()));\n      } catch {\n        /* ignore */\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/test/test_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_config.d.ts","names":[],"sources":["../../src/test/test_config.ts"],"mappings":";;;;;;;;;UAgBiB,UAAA;EACf,OAAA;EACA,UAAA;EACA,SAAA;EACA,aAAA;AAAA;AAAA,iBAac,aAAA,CAAA,GAAiB,UAAA;;cAsBpB,oBAAA;;iBAGG,qBAAA,CAAsB,OAAA,WAAkB,cAAA;AAAA,iBAqClC,iBAAA,CAAA,GAAqB,OAAA;EAAU,IAAA,EAAM,cAAA;EAAgB,IAAA,EAAM,OAAA;AAAA;AAAA,iBA2D3D,eAAA,CAAgB,aAAA,GAAe,OAAA,CAAQ,cAAA,IAAoB,OAAA,CAAA,UAAA;AAAA,iBAK3D,aAAA,CACpB,eAAA,WACA,aAAA,GAAe,OAAA,CAAQ,cAAA,IAAoB,OAAA,CAAA,QAAA;AAAA,KAQjC,mBAAA;EAvJV;;EA2JI,WAAA,QAzJS;EA2JT,cAAA;AAAA;EAGA,WAAA;AAAA;AAAA,iBAGgB,YAAA,GAAA,CAAgB,IAAA,GAAO,EAAA,EAAI,QAAA,KAAa,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;AAAA,iBAE7D,YAAA,GAAA,CACpB,IAAA,GAAO,EAAA,EAAI,QAAA,EAAU,KAAA,EAAO,OAAA,CAAQ,UAAA,QAAkB,aAAA,OAAoB,OAAA,CAAQ,CAAA,GAClF,OAAA;EACE,WAAA;EACA,cAAA;AAAA,IAED,OAAA,CAAQ,CAAA"}

package/dist/test/test_config.js

@@ -9,10 +9,9 @@ import { startTcpProxy } from "./tcp-proxy.js";
 import { randomUUID } from "node:crypto";
 import * as fs$1 from "node:fs";
 import * as path from "node:path";
-
 //#region src/test/test_config.ts
 var test_config_exports = /* @__PURE__ */ __exportAll({
-	TEST_REQUEST_TIMEOUT: () => TEST_REQUEST_TIMEOUT,
+	TEST_REQUEST_TIMEOUT: () => 500,
 	getTestClient: () => getTestClient,
 	getTestClientConf: () => getTestClientConf,
 	getTestConfig: () => getTestConfig,
@@ -36,12 +35,10 @@ function getTestConfig() {
 	if (conf.address === void 0) throw new Error(`can't resolve platform address (checked ${CONFIG_FILE} file and PL_ADDRESS environment var)`);
 	return conf;
 }
-/** Default request timeout for tests (ms) */
-const TEST_REQUEST_TIMEOUT = 500;
 /** Returns PlClientConfig with reduced timeout for tests */
 function plAddressToTestConfig(address) {
 	const plConf = plAddressToConfig(address);
-	plConf.defaultRequestTimeout = TEST_REQUEST_TIMEOUT;
+	plConf.defaultRequestTimeout = 500;
 	return plConf;
 }
 function saveAuthInfoCallback(tConf) {
@@ -157,7 +154,7 @@ async function withTempRoot(body, options = {}) {
 		}
 	}
 }
-
 //#endregion
 export { test_config_exports };
+
 //# sourceMappingURL=test_config.js.map

package/dist/test/test_config.js.map

@@ -1 +1 @@
-{"version":3,"file":"test_config.js","names":["fs"],"sources":["../../src/test/test_config.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport { LLPlClient } from \"../core/ll_client\";\nimport type { AuthInformation, AuthOps, PlClientConfig } from \"../core/config\";\nimport { plAddressToConfig } from \"../core/config\";\nimport { UnauthenticatedPlClient } from \"../core/unauth_client\";\nimport { PlClient } from \"../core/client\";\nimport { randomUUID } from \"node:crypto\";\nimport type { OptionalResourceId } from \"../core/types\";\nimport { NullResourceId, resourceIdToString } from \"../core/types\";\nimport { inferAuthRefreshTime } from \"../core/auth\";\nimport * as path from \"node:path\";\nimport type { TestTcpProxy } from \"./tcp-proxy\";\nimport { startTcpProxy } from \"./tcp-proxy\";\n\nexport { TestTcpProxy };\n\nexport interface TestConfig {\n  address: string;\n  test_proxy?: string;\n  test_user?: string;\n  test_password?: string;\n}\n\nconst CONFIG_FILE = \"test_config.json\";\n// const AUTH_DATA_FILE = '.test_auth.json';\n\nlet authDataFilePath: string | undefined;\n\nfunction getFullAuthDataFilePath() {\n  if (authDataFilePath === undefined) authDataFilePath = path.resolve(\".test_auth.json\");\n  return authDataFilePath;\n}\n\nexport function getTestConfig(): TestConfig {\n  let conf: Partial<TestConfig> = {};\n  if (fs.existsSync(CONFIG_FILE))\n    conf = JSON.parse(fs.readFileSync(CONFIG_FILE, { encoding: \"utf-8\" })) as TestConfig;\n\n  if (process.env.PL_ADDRESS !== undefined) conf.address = process.env.PL_ADDRESS;\n\n  if (process.env.PL_TEST_USER !== undefined) conf.test_user = process.env.PL_TEST_USER;\n\n  if (process.env.PL_TEST_PASSWORD !== undefined) conf.test_password = process.env.PL_TEST_PASSWORD;\n\n  if (process.env.PL_TEST_PROXY !== undefined) conf.test_proxy = process.env.PL_TEST_PROXY;\n\n  if (conf.address === undefined)\n    throw new Error(\n      `can't resolve platform address (checked ${CONFIG_FILE} file and PL_ADDRESS environment var)`,\n    );\n\n  return conf as TestConfig;\n}\n\n/** Default request timeout for tests (ms) */\nexport const TEST_REQUEST_TIMEOUT = 500;\n\n/** Returns PlClientConfig with reduced timeout for tests */\nexport function plAddressToTestConfig(address: string): PlClientConfig {\n  const plConf = plAddressToConfig(address);\n  plConf.defaultRequestTimeout = TEST_REQUEST_TIMEOUT;\n  return plConf;\n}\n\ninterface AuthCache {\n  /** To check if config changed */\n  conf: TestConfig;\n  expiration: number;\n  authInformation: AuthInformation;\n}\n\nfunction saveAuthInfoCallback(tConf: TestConfig): (authInformation: AuthInformation) => void {\n  return (authInformation) => {\n    const dst = getFullAuthDataFilePath();\n    const tmpDst = getFullAuthDataFilePath() + randomUUID();\n    fs.writeFileSync(\n      tmpDst,\n      Buffer.from(\n        JSON.stringify({\n          conf: tConf,\n          authInformation,\n          expiration: inferAuthRefreshTime(authInformation, 24 * 60 * 60),\n        } as AuthCache),\n      ),\n      \"utf8\",\n    );\n    fs.renameSync(tmpDst, dst);\n  };\n}\n\nconst cleanAuthInfoCallback = () => {\n  console.warn(`Removing: ${getFullAuthDataFilePath()}`);\n  fs.rmSync(getFullAuthDataFilePath());\n};\n\nexport async function getTestClientConf(): Promise<{ conf: PlClientConfig; auth: AuthOps }> {\n  const tConf = getTestConfig();\n\n  let authInformation: AuthInformation | undefined = undefined;\n\n  // try recover from cache\n  if (fs.existsSync(getFullAuthDataFilePath())) {\n    try {\n      const cache: AuthCache = JSON.parse(\n        fs.readFileSync(getFullAuthDataFilePath(), { encoding: \"utf-8\" }),\n      ) as AuthCache; // TODO runtime validation\n      if (\n        cache.conf.address === tConf.address &&\n        cache.conf.test_user === tConf.test_user &&\n        cache.conf.test_password === tConf.test_password &&\n        cache.expiration > Date.now()\n      )\n        authInformation = cache.authInformation;\n    } catch {\n      // removing cache file on any error\n      fs.rmSync(getFullAuthDataFilePath());\n    }\n  }\n\n  const plConf = plAddressToTestConfig(tConf.address);\n  const uClient = await UnauthenticatedPlClient.build(plConf);\n\n  const requireAuth = await uClient.requireAuth();\n\n  if (!requireAuth && (tConf.test_user !== undefined || tConf.test_password !== undefined))\n    throw new Error(\n      `Server require no auth, but test user name or test password are provided via (${CONFIG_FILE}) or env variables: PL_TEST_USER and PL_TEST_PASSWORD`,\n    );\n\n  if (requireAuth && (tConf.test_user === undefined || tConf.test_password === undefined))\n    throw new Error(\n      `No auth information found in config (${CONFIG_FILE}) or env variables: PL_TEST_USER and PL_TEST_PASSWORD`,\n    );\n\n  if (authInformation === undefined) {\n    if (requireAuth) authInformation = await uClient.login(tConf.test_user!, tConf.test_password!);\n    // No authorization is required\n    else authInformation = {};\n\n    // saving cache\n    saveAuthInfoCallback(tConf)(authInformation);\n  }\n\n  return {\n    conf: plConf,\n    auth: {\n      authInformation,\n      onUpdate: saveAuthInfoCallback(tConf),\n      onAuthError: cleanAuthInfoCallback,\n      onUpdateError: cleanAuthInfoCallback,\n    },\n  };\n}\n\nexport async function getTestLLClient(confOverrides: Partial<PlClientConfig> = {}) {\n  const { conf, auth } = await getTestClientConf();\n  return await LLPlClient.build({ ...conf, ...confOverrides }, { auth });\n}\n\nexport async function getTestClient(\n  alternativeRoot?: string,\n  confOverrides: Partial<PlClientConfig> = {},\n) {\n  const { conf, auth } = await getTestClientConf();\n  if (alternativeRoot !== undefined && conf.alternativeRoot !== undefined)\n    throw new Error(\"test pl address configured with alternative root\");\n  return await PlClient.init({ ...conf, ...confOverrides, alternativeRoot }, auth);\n}\n\nexport type WithTempRootOptions =\n  | {\n      /** If true and PL_ADDRESS is http://localhost or http://127.0.0.1:<port>,\n       * a TCP proxy will be started and PL client will connect through it. */\n      viaTcpProxy: true;\n      /** Artificial latency for proxy (ms). Default 0 */\n      proxyLatencyMs?: number;\n    }\n  | {\n      viaTcpProxy?: undefined;\n    };\n\nexport async function withTempRoot<T>(body: (pl: PlClient) => Promise<T>): Promise<T | void>;\n\nexport async function withTempRoot<T>(\n  body: (pl: PlClient, proxy: Awaited<ReturnType<typeof startTcpProxy>>) => Promise<T>,\n  options: {\n    viaTcpProxy: true;\n    proxyLatencyMs?: number;\n  },\n): Promise<T>;\n\nexport async function withTempRoot<T>(\n  body: (pl: PlClient, proxy: any) => Promise<T>,\n  options: WithTempRootOptions = {},\n): Promise<T | undefined> {\n  const alternativeRoot = `test_${Date.now()}_${randomUUID()}`;\n  let altRootId: OptionalResourceId = NullResourceId;\n  // Proxy management\n  let proxy: Awaited<ReturnType<typeof startTcpProxy>> | undefined;\n  let confOverrides: Partial<PlClientConfig> = {};\n  try {\n    // Optionally start TCP proxy and rewrite PL_ADDRESS to point to proxy\n    if (options.viaTcpProxy === true && process.env.PL_ADDRESS) {\n      try {\n        const url = new URL(process.env.PL_ADDRESS);\n        const isHttp = url.protocol === \"http:\";\n        const isLocal = url.hostname === \"127.0.0.1\" || url.hostname === \"localhost\";\n        const port = parseInt(url.port);\n        if (isHttp && isLocal && Number.isFinite(port)) {\n          proxy = await startTcpProxy({ targetPort: port, latency: options.proxyLatencyMs ?? 0 });\n          // Override client connection host:port to proxy\n          confOverrides = { hostAndPort: `127.0.0.1:${proxy.port}` } as Partial<PlClientConfig>;\n        } else {\n          console.warn(\n            \"*** skipping proxy-based test, PL_ADDRESS is not localhost\",\n            process.env.PL_ADDRESS,\n          );\n          return;\n        }\n      } catch {\n        // ignore proxy setup errors; tests will run against original address\n      }\n    }\n\n    const client = await getTestClient(alternativeRoot, confOverrides);\n    altRootId = client.clientRoot;\n    try {\n      const value = await body(client, proxy);\n      const rawClient = await getTestClient();\n      try {\n        await rawClient.deleteAlternativeRoot(alternativeRoot);\n      } catch (cleanupErr: any) {\n        // Cleanup may fail if test intentionally deleted resources\n        console.warn(`Failed to clean up alternative root ${alternativeRoot}:`, cleanupErr.message);\n      } finally {\n        // Close the cleanup client to avoid dangling gRPC channels that can cause\n        // segfaults during process exit\n        await rawClient.close();\n      }\n      return value;\n    } finally {\n      // Close the test client to avoid dangling gRPC channels\n      await client.close();\n    }\n  } catch (err: any) {\n    console.log(`ALTERNATIVE ROOT: ${alternativeRoot} (${resourceIdToString(altRootId)})`);\n    throw err;\n    // throw new Error('withTempRoot error: ' + err.message, { cause: err });\n  } finally {\n    // Stop proxy if started\n    if (proxy) {\n      try {\n        await proxy.disconnectAll();\n      } catch {\n        /* ignore */\n      }\n      try {\n        await new Promise<void>((resolve) => proxy!.server.close(() => resolve()));\n      } catch {\n        /* ignore */\n      }\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"test_config.js","names":["fs"],"sources":["../../src/test/test_config.ts"],"sourcesContent":["import * as fs from \"node:fs\";\nimport { LLPlClient } from \"../core/ll_client\";\nimport type { AuthInformation, AuthOps, PlClientConfig } from \"../core/config\";\nimport { plAddressToConfig } from \"../core/config\";\nimport { UnauthenticatedPlClient } from \"../core/unauth_client\";\nimport { PlClient } from \"../core/client\";\nimport { randomUUID } from \"node:crypto\";\nimport type { OptionalResourceId } from \"../core/types\";\nimport { NullResourceId, resourceIdToString } from \"../core/types\";\nimport { inferAuthRefreshTime } from \"../core/auth\";\nimport * as path from \"node:path\";\nimport type { TestTcpProxy } from \"./tcp-proxy\";\nimport { startTcpProxy } from \"./tcp-proxy\";\n\nexport { TestTcpProxy };\n\nexport interface TestConfig {\n  address: string;\n  test_proxy?: string;\n  test_user?: string;\n  test_password?: string;\n}\n\nconst CONFIG_FILE = \"test_config.json\";\n// const AUTH_DATA_FILE = '.test_auth.json';\n\nlet authDataFilePath: string | undefined;\n\nfunction getFullAuthDataFilePath() {\n  if (authDataFilePath === undefined) authDataFilePath = path.resolve(\".test_auth.json\");\n  return authDataFilePath;\n}\n\nexport function getTestConfig(): TestConfig {\n  let conf: Partial<TestConfig> = {};\n  if (fs.existsSync(CONFIG_FILE))\n    conf = JSON.parse(fs.readFileSync(CONFIG_FILE, { encoding: \"utf-8\" })) as TestConfig;\n\n  if (process.env.PL_ADDRESS !== undefined) conf.address = process.env.PL_ADDRESS;\n\n  if (process.env.PL_TEST_USER !== undefined) conf.test_user = process.env.PL_TEST_USER;\n\n  if (process.env.PL_TEST_PASSWORD !== undefined) conf.test_password = process.env.PL_TEST_PASSWORD;\n\n  if (process.env.PL_TEST_PROXY !== undefined) conf.test_proxy = process.env.PL_TEST_PROXY;\n\n  if (conf.address === undefined)\n    throw new Error(\n      `can't resolve platform address (checked ${CONFIG_FILE} file and PL_ADDRESS environment var)`,\n    );\n\n  return conf as TestConfig;\n}\n\n/** Default request timeout for tests (ms) */\nexport const TEST_REQUEST_TIMEOUT = 500;\n\n/** Returns PlClientConfig with reduced timeout for tests */\nexport function plAddressToTestConfig(address: string): PlClientConfig {\n  const plConf = plAddressToConfig(address);\n  plConf.defaultRequestTimeout = TEST_REQUEST_TIMEOUT;\n  return plConf;\n}\n\ninterface AuthCache {\n  /** To check if config changed */\n  conf: TestConfig;\n  expiration: number;\n  authInformation: AuthInformation;\n}\n\nfunction saveAuthInfoCallback(tConf: TestConfig): (authInformation: AuthInformation) => void {\n  return (authInformation) => {\n    const dst = getFullAuthDataFilePath();\n    const tmpDst = getFullAuthDataFilePath() + randomUUID();\n    fs.writeFileSync(\n      tmpDst,\n      Buffer.from(\n        JSON.stringify({\n          conf: tConf,\n          authInformation,\n          expiration: inferAuthRefreshTime(authInformation, 24 * 60 * 60),\n        } as AuthCache),\n      ),\n      \"utf8\",\n    );\n    fs.renameSync(tmpDst, dst);\n  };\n}\n\nconst cleanAuthInfoCallback = () => {\n  console.warn(`Removing: ${getFullAuthDataFilePath()}`);\n  fs.rmSync(getFullAuthDataFilePath());\n};\n\nexport async function getTestClientConf(): Promise<{ conf: PlClientConfig; auth: AuthOps }> {\n  const tConf = getTestConfig();\n\n  let authInformation: AuthInformation | undefined = undefined;\n\n  // try recover from cache\n  if (fs.existsSync(getFullAuthDataFilePath())) {\n    try {\n      const cache: AuthCache = JSON.parse(\n        fs.readFileSync(getFullAuthDataFilePath(), { encoding: \"utf-8\" }),\n      ) as AuthCache; // TODO runtime validation\n      if (\n        cache.conf.address === tConf.address &&\n        cache.conf.test_user === tConf.test_user &&\n        cache.conf.test_password === tConf.test_password &&\n        cache.expiration > Date.now()\n      )\n        authInformation = cache.authInformation;\n    } catch {\n      // removing cache file on any error\n      fs.rmSync(getFullAuthDataFilePath());\n    }\n  }\n\n  const plConf = plAddressToTestConfig(tConf.address);\n  const uClient = await UnauthenticatedPlClient.build(plConf);\n\n  const requireAuth = await uClient.requireAuth();\n\n  if (!requireAuth && (tConf.test_user !== undefined || tConf.test_password !== undefined))\n    throw new Error(\n      `Server require no auth, but test user name or test password are provided via (${CONFIG_FILE}) or env variables: PL_TEST_USER and PL_TEST_PASSWORD`,\n    );\n\n  if (requireAuth && (tConf.test_user === undefined || tConf.test_password === undefined))\n    throw new Error(\n      `No auth information found in config (${CONFIG_FILE}) or env variables: PL_TEST_USER and PL_TEST_PASSWORD`,\n    );\n\n  if (authInformation === undefined) {\n    if (requireAuth) authInformation = await uClient.login(tConf.test_user!, tConf.test_password!);\n    // No authorization is required\n    else authInformation = {};\n\n    // saving cache\n    saveAuthInfoCallback(tConf)(authInformation);\n  }\n\n  return {\n    conf: plConf,\n    auth: {\n      authInformation,\n      onUpdate: saveAuthInfoCallback(tConf),\n      onAuthError: cleanAuthInfoCallback,\n      onUpdateError: cleanAuthInfoCallback,\n    },\n  };\n}\n\nexport async function getTestLLClient(confOverrides: Partial<PlClientConfig> = {}) {\n  const { conf, auth } = await getTestClientConf();\n  return await LLPlClient.build({ ...conf, ...confOverrides }, { auth });\n}\n\nexport async function getTestClient(\n  alternativeRoot?: string,\n  confOverrides: Partial<PlClientConfig> = {},\n) {\n  const { conf, auth } = await getTestClientConf();\n  if (alternativeRoot !== undefined && conf.alternativeRoot !== undefined)\n    throw new Error(\"test pl address configured with alternative root\");\n  return await PlClient.init({ ...conf, ...confOverrides, alternativeRoot }, auth);\n}\n\nexport type WithTempRootOptions =\n  | {\n      /** If true and PL_ADDRESS is http://localhost or http://127.0.0.1:<port>,\n       * a TCP proxy will be started and PL client will connect through it. */\n      viaTcpProxy: true;\n      /** Artificial latency for proxy (ms). Default 0 */\n      proxyLatencyMs?: number;\n    }\n  | {\n      viaTcpProxy?: undefined;\n    };\n\nexport async function withTempRoot<T>(body: (pl: PlClient) => Promise<T>): Promise<T | void>;\n\nexport async function withTempRoot<T>(\n  body: (pl: PlClient, proxy: Awaited<ReturnType<typeof startTcpProxy>>) => Promise<T>,\n  options: {\n    viaTcpProxy: true;\n    proxyLatencyMs?: number;\n  },\n): Promise<T>;\n\nexport async function withTempRoot<T>(\n  body: (pl: PlClient, proxy: any) => Promise<T>,\n  options: WithTempRootOptions = {},\n): Promise<T | undefined> {\n  const alternativeRoot = `test_${Date.now()}_${randomUUID()}`;\n  let altRootId: OptionalResourceId = NullResourceId;\n  // Proxy management\n  let proxy: Awaited<ReturnType<typeof startTcpProxy>> | undefined;\n  let confOverrides: Partial<PlClientConfig> = {};\n  try {\n    // Optionally start TCP proxy and rewrite PL_ADDRESS to point to proxy\n    if (options.viaTcpProxy === true && process.env.PL_ADDRESS) {\n      try {\n        const url = new URL(process.env.PL_ADDRESS);\n        const isHttp = url.protocol === \"http:\";\n        const isLocal = url.hostname === \"127.0.0.1\" || url.hostname === \"localhost\";\n        const port = parseInt(url.port);\n        if (isHttp && isLocal && Number.isFinite(port)) {\n          proxy = await startTcpProxy({ targetPort: port, latency: options.proxyLatencyMs ?? 0 });\n          // Override client connection host:port to proxy\n          confOverrides = { hostAndPort: `127.0.0.1:${proxy.port}` } as Partial<PlClientConfig>;\n        } else {\n          console.warn(\n            \"*** skipping proxy-based test, PL_ADDRESS is not localhost\",\n            process.env.PL_ADDRESS,\n          );\n          return;\n        }\n      } catch {\n        // ignore proxy setup errors; tests will run against original address\n      }\n    }\n\n    const client = await getTestClient(alternativeRoot, confOverrides);\n    altRootId = client.clientRoot;\n    try {\n      const value = await body(client, proxy);\n      const rawClient = await getTestClient();\n      try {\n        await rawClient.deleteAlternativeRoot(alternativeRoot);\n      } catch (cleanupErr: any) {\n        // Cleanup may fail if test intentionally deleted resources\n        console.warn(`Failed to clean up alternative root ${alternativeRoot}:`, cleanupErr.message);\n      } finally {\n        // Close the cleanup client to avoid dangling gRPC channels that can cause\n        // segfaults during process exit\n        await rawClient.close();\n      }\n      return value;\n    } finally {\n      // Close the test client to avoid dangling gRPC channels\n      await client.close();\n    }\n  } catch (err: any) {\n    console.log(`ALTERNATIVE ROOT: ${alternativeRoot} (${resourceIdToString(altRootId)})`);\n    throw err;\n    // throw new Error('withTempRoot error: ' + err.message, { cause: err });\n  } finally {\n    // Stop proxy if started\n    if (proxy) {\n      try {\n        await proxy.disconnectAll();\n      } catch {\n        /* ignore */\n      }\n      try {\n        await new Promise<void>((resolve) => proxy!.server.close(() => resolve()));\n      } catch {\n        /* ignore */\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAuBA,MAAM,cAAc;AAGpB,IAAI;AAEJ,SAAS,0BAA0B;AACjC,KAAI,qBAAqB,KAAA,EAAW,oBAAmB,KAAK,QAAQ,kBAAkB;AACtF,QAAO;;AAGT,SAAgB,gBAA4B;CAC1C,IAAI,OAA4B,EAAE;AAClC,KAAIA,KAAG,WAAW,YAAY,CAC5B,QAAO,KAAK,MAAMA,KAAG,aAAa,aAAa,EAAE,UAAU,SAAS,CAAC,CAAC;AAExE,KAAI,QAAQ,IAAI,eAAe,KAAA,EAAW,MAAK,UAAU,QAAQ,IAAI;AAErE,KAAI,QAAQ,IAAI,iBAAiB,KAAA,EAAW,MAAK,YAAY,QAAQ,IAAI;AAEzE,KAAI,QAAQ,IAAI,qBAAqB,KAAA,EAAW,MAAK,gBAAgB,QAAQ,IAAI;AAEjF,KAAI,QAAQ,IAAI,kBAAkB,KAAA,EAAW,MAAK,aAAa,QAAQ,IAAI;AAE3E,KAAI,KAAK,YAAY,KAAA,EACnB,OAAM,IAAI,MACR,2CAA2C,YAAY,uCACxD;AAEH,QAAO;;;AAOT,SAAgB,sBAAsB,SAAiC;CACrE,MAAM,SAAS,kBAAkB,QAAQ;AACzC,QAAO,wBAAA;AACP,QAAO;;AAUT,SAAS,qBAAqB,OAA+D;AAC3F,SAAQ,oBAAoB;EAC1B,MAAM,MAAM,yBAAyB;EACrC,MAAM,SAAS,yBAAyB,GAAG,YAAY;AACvD,OAAG,cACD,QACA,OAAO,KACL,KAAK,UAAU;GACb,MAAM;GACN;GACA,YAAY,qBAAqB,iBAAiB,OAAU,GAAG;GAChE,CAAc,CAChB,EACD,OACD;AACD,OAAG,WAAW,QAAQ,IAAI;;;AAI9B,MAAM,8BAA8B;AAClC,SAAQ,KAAK,aAAa,yBAAyB,GAAG;AACtD,MAAG,OAAO,yBAAyB,CAAC;;AAGtC,eAAsB,oBAAsE;CAC1F,MAAM,QAAQ,eAAe;CAE7B,IAAI,kBAA+C,KAAA;AAGnD,KAAIA,KAAG,WAAW,yBAAyB,CAAC,CAC1C,KAAI;EACF,MAAM,QAAmB,KAAK,MAC5BA,KAAG,aAAa,yBAAyB,EAAE,EAAE,UAAU,SAAS,CAAC,CAClE;AACD,MACE,MAAM,KAAK,YAAY,MAAM,WAC7B,MAAM,KAAK,cAAc,MAAM,aAC/B,MAAM,KAAK,kBAAkB,MAAM,iBACnC,MAAM,aAAa,KAAK,KAAK,CAE7B,mBAAkB,MAAM;SACpB;AAEN,OAAG,OAAO,yBAAyB,CAAC;;CAIxC,MAAM,SAAS,sBAAsB,MAAM,QAAQ;CACnD,MAAM,UAAU,MAAM,wBAAwB,MAAM,OAAO;CAE3D,MAAM,cAAc,MAAM,QAAQ,aAAa;AAE/C,KAAI,CAAC,gBAAgB,MAAM,cAAc,KAAA,KAAa,MAAM,kBAAkB,KAAA,GAC5E,OAAM,IAAI,MACR,iFAAiF,YAAY,uDAC9F;AAEH,KAAI,gBAAgB,MAAM,cAAc,KAAA,KAAa,MAAM,kBAAkB,KAAA,GAC3E,OAAM,IAAI,MACR,wCAAwC,YAAY,uDACrD;AAEH,KAAI,oBAAoB,KAAA,GAAW;AACjC,MAAI,YAAa,mBAAkB,MAAM,QAAQ,MAAM,MAAM,WAAY,MAAM,cAAe;MAEzF,mBAAkB,EAAE;AAGzB,uBAAqB,MAAM,CAAC,gBAAgB;;AAG9C,QAAO;EACL,MAAM;EACN,MAAM;GACJ;GACA,UAAU,qBAAqB,MAAM;GACrC,aAAa;GACb,eAAe;GAChB;EACF;;AAGH,eAAsB,gBAAgB,gBAAyC,EAAE,EAAE;CACjF,MAAM,EAAE,MAAM,SAAS,MAAM,mBAAmB;AAChD,QAAO,MAAM,WAAW,MAAM;EAAE,GAAG;EAAM,GAAG;EAAe,EAAE,EAAE,MAAM,CAAC;;AAGxE,eAAsB,cACpB,iBACA,gBAAyC,EAAE,EAC3C;CACA,MAAM,EAAE,MAAM,SAAS,MAAM,mBAAmB;AAChD,KAAI,oBAAoB,KAAA,KAAa,KAAK,oBAAoB,KAAA,EAC5D,OAAM,IAAI,MAAM,mDAAmD;AACrE,QAAO,MAAM,SAAS,KAAK;EAAE,GAAG;EAAM,GAAG;EAAe;EAAiB,EAAE,KAAK;;AAyBlF,eAAsB,aACpB,MACA,UAA+B,EAAE,EACT;CACxB,MAAM,kBAAkB,QAAQ,KAAK,KAAK,CAAC,GAAG,YAAY;CAC1D,IAAI,YAAgC;CAEpC,IAAI;CACJ,IAAI,gBAAyC,EAAE;AAC/C,KAAI;AAEF,MAAI,QAAQ,gBAAgB,QAAQ,QAAQ,IAAI,WAC9C,KAAI;GACF,MAAM,MAAM,IAAI,IAAI,QAAQ,IAAI,WAAW;GAC3C,MAAM,SAAS,IAAI,aAAa;GAChC,MAAM,UAAU,IAAI,aAAa,eAAe,IAAI,aAAa;GACjE,MAAM,OAAO,SAAS,IAAI,KAAK;AAC/B,OAAI,UAAU,WAAW,OAAO,SAAS,KAAK,EAAE;AAC9C,YAAQ,MAAM,cAAc;KAAE,YAAY;KAAM,SAAS,QAAQ,kBAAkB;KAAG,CAAC;AAEvF,oBAAgB,EAAE,aAAa,aAAa,MAAM,QAAQ;UACrD;AACL,YAAQ,KACN,8DACA,QAAQ,IAAI,WACb;AACD;;UAEI;EAKV,MAAM,SAAS,MAAM,cAAc,iBAAiB,cAAc;AAClE,cAAY,OAAO;AACnB,MAAI;GACF,MAAM,QAAQ,MAAM,KAAK,QAAQ,MAAM;GACvC,MAAM,YAAY,MAAM,eAAe;AACvC,OAAI;AACF,UAAM,UAAU,sBAAsB,gBAAgB;YAC/C,YAAiB;AAExB,YAAQ,KAAK,uCAAuC,gBAAgB,IAAI,WAAW,QAAQ;aACnF;AAGR,UAAM,UAAU,OAAO;;AAEzB,UAAO;YACC;AAER,SAAM,OAAO,OAAO;;UAEf,KAAU;AACjB,UAAQ,IAAI,qBAAqB,gBAAgB,IAAI,mBAAmB,UAAU,CAAC,GAAG;AACtF,QAAM;WAEE;AAER,MAAI,OAAO;AACT,OAAI;AACF,UAAM,MAAM,eAAe;WACrB;AAGR,OAAI;AACF,UAAM,IAAI,SAAe,YAAY,MAAO,OAAO,YAAY,SAAS,CAAC,CAAC;WACpE"}

package/dist/util/pl.cjs

@@ -1,9 +1,8 @@
-
 //#region src/util/pl.ts
 function parsePlJwt(token) {
 	return JSON.parse(Buffer.from(token.split(".")[1], "base64").toString());
 }
-
 //#endregion
 exports.parsePlJwt = parsePlJwt;
+
 //# sourceMappingURL=pl.cjs.map

package/dist/util/pl.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"pl.cjs","names":[],"sources":["../../src/util/pl.ts"],"sourcesContent":["export type PlJWTPayload = {\n  user: {\n    login: string;\n  };\n  exp: number;\n  iat: number;\n};\n\nexport function parsePlJwt(token: string): PlJWTPayload {\n  return JSON.parse(Buffer.from(token.split(\".\")[1], \"base64\").toString());\n}\n"],"mappings":";;AAQA,SAAgB,WAAW,OAA6B;AACtD,QAAO,KAAK,MAAM,OAAO,KAAK,MAAM,MAAM,IAAI,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC"}
+{"version":3,"file":"pl.cjs","names":[],"sources":["../../src/util/pl.ts"],"sourcesContent":["export type PlJWTPayload = {\n  user: {\n    login: string;\n  };\n  exp: number;\n  iat: number;\n};\n\nexport function parsePlJwt(token: string): PlJWTPayload {\n  return JSON.parse(Buffer.from(token.split(\".\")[1], \"base64\").toString());\n}\n"],"mappings":";AAQA,SAAgB,WAAW,OAA6B;AACtD,QAAO,KAAK,MAAM,OAAO,KAAK,MAAM,MAAM,IAAI,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC"}

package/dist/util/pl.js

@@ -2,7 +2,7 @@
 function parsePlJwt(token) {
 	return JSON.parse(Buffer.from(token.split(".")[1], "base64").toString());
 }
-
 //#endregion
 export { parsePlJwt };
+
 //# sourceMappingURL=pl.js.map

package/dist/util/util.cjs

@@ -1,4 +1,3 @@
-
 //#region src/util/util.ts
 function isArrayBufferOrView(value) {
 	return value instanceof ArrayBuffer || ArrayBuffer.isView(value);
@@ -8,7 +7,7 @@ function toBytes(value) {
 	else if (isArrayBufferOrView(value)) return value;
 	else throw new Error(`Unexpected type: ${value}`);
 }
-
 //#endregion
 exports.toBytes = toBytes;
+
 //# sourceMappingURL=util.cjs.map

package/dist/util/util.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"util.cjs","names":[],"sources":["../../src/util/util.ts"],"sourcesContent":["function isArrayBufferOrView(value: unknown): value is ArrayBufferLike {\n  return value instanceof ArrayBuffer || ArrayBuffer.isView(value);\n}\n\nexport function toBytes(value: string | Uint8Array): Uint8Array {\n  if (typeof value === \"string\") return Buffer.from(value);\n  else if (isArrayBufferOrView(value)) return value;\n  // eslint-disable-next-line @typescript-eslint/restrict-template-expressions\n  else throw new Error(`Unexpected type: ${value}`);\n}\n"],"mappings":";;AAAA,SAAS,oBAAoB,OAA0C;AACrE,QAAO,iBAAiB,eAAe,YAAY,OAAO,MAAM;;AAGlE,SAAgB,QAAQ,OAAwC;AAC9D,KAAI,OAAO,UAAU,SAAU,QAAO,OAAO,KAAK,MAAM;UAC/C,oBAAoB,MAAM,CAAE,QAAO;KAEvC,OAAM,IAAI,MAAM,oBAAoB,QAAQ"}
+{"version":3,"file":"util.cjs","names":[],"sources":["../../src/util/util.ts"],"sourcesContent":["function isArrayBufferOrView(value: unknown): value is ArrayBufferLike {\n  return value instanceof ArrayBuffer || ArrayBuffer.isView(value);\n}\n\nexport function toBytes(value: string | Uint8Array): Uint8Array {\n  if (typeof value === \"string\") return Buffer.from(value);\n  else if (isArrayBufferOrView(value)) return value;\n  // eslint-disable-next-line @typescript-eslint/restrict-template-expressions\n  else throw new Error(`Unexpected type: ${value}`);\n}\n"],"mappings":";AAAA,SAAS,oBAAoB,OAA0C;AACrE,QAAO,iBAAiB,eAAe,YAAY,OAAO,MAAM;;AAGlE,SAAgB,QAAQ,OAAwC;AAC9D,KAAI,OAAO,UAAU,SAAU,QAAO,OAAO,KAAK,MAAM;UAC/C,oBAAoB,MAAM,CAAE,QAAO;KAEvC,OAAM,IAAI,MAAM,oBAAoB,QAAQ"}

package/dist/util/util.js

@@ -7,7 +7,7 @@ function toBytes(value) {
 	else if (isArrayBufferOrView(value)) return value;
 	else throw new Error(`Unexpected type: ${value}`);
 }
-
 //#endregion
 export { toBytes };
+
 //# sourceMappingURL=util.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-client",
-  "version": "2.18.5",
+  "version": "3.1.0",
   "description": "New TS/JS client for Platform API",
   "files": [
     "./dist/**/*",
@@ -30,20 +30,20 @@
     "undici": "~7.16.0",
     "utility-types": "^3.11.0",
     "yaml": "^2.8.0",
+    "@milaboratories/pl-model-common": "1.31.1",
     "@milaboratories/pl-http": "1.2.4",
-    "@milaboratories/ts-helpers": "1.8.1",
-    "@milaboratories/pl-model-common": "1.31.1"
+    "@milaboratories/ts-helpers": "1.8.1"
   },
   "devDependencies": {
     "@protobuf-ts/plugin": "2.11.1",
     "@types/node": "~24.5.2",
-    "@vitest/coverage-istanbul": "^4.0.18",
+    "@vitest/coverage-istanbul": "^4.1.3",
     "openapi-typescript": "^7.10.0",
     "typescript": "~5.9.3",
-    "vitest": "^4.0.18",
-    "@milaboratories/ts-builder": "1.3.0",
-    "@milaboratories/build-configs": "1.5.2",
-    "@milaboratories/ts-configs": "1.2.2"
+    "vitest": "^4.1.3",
+    "@milaboratories/ts-builder": "1.3.1",
+    "@milaboratories/build-configs": "2.0.0",
+    "@milaboratories/ts-configs": "1.2.3"
   },
   "engines": {
     "node": ">=22.19.0"

package/src/core/client.ts

@@ -5,8 +5,14 @@ import type { AnyResourceRef } from "./transaction";
 import { PlTransaction, toGlobalResourceId, TxCommitConflict } from "./transaction";
 import { createHash } from "node:crypto";
 import type { OptionalResourceId, ResourceId } from "./types";
-import { ensureResourceIdNotNull, isNullResourceId, NullResourceId } from "./types";
+import {
+  bigintToResourceId,
+  ensureResourceIdNotNull,
+  isNullResourceId,
+  NullResourceId,
+} from "./types";
 import { ClientRoot } from "../helpers/pl";
+import { isUnimplementedError } from "./errors";
 import type { MiLogger, RetryOptions } from "@milaboratories/ts-helpers";
 import { assertNever, createRetryState, nextRetryStateOrError } from "@milaboratories/ts-helpers";
 import type { PlDriver, PlDriverDefinition } from "./driver";
@@ -203,7 +209,9 @@ export class PlClient {
     return this._serverInfo!;
   }
 
-  /** Currently implements custom logic to emulate future behaviour with single root. */
+  /** Discovers or creates the user's root resource.
+   *  Tries ListUserResources RPC first (new backend), falls back to
+   *  legacy named-resource lookup for older backends. */
   private async init() {
     if (this.initialized) throw new Error("Already initialized");
 
@@ -216,45 +224,87 @@ export class PlClient {
     this._ll = await this.buildLLPlClient(false);
     const wireProtocol = this._ll.wireProtocol;
 
-    // calculating reproducible root name from the username
-    const user = this._ll.authUser;
-    const mainRootName =
-      user === null ? AnonymousClientRoot : createHash("sha256").update(user).digest("hex");
-
     this._serverInfo = await this.ping();
     if (this._serverInfo.compression === MaintenanceAPI_Ping_Response_Compression.GZIP) {
       await this._ll.close();
       this._ll = await this.buildLLPlClient(true, wireProtocol);
     }
 
-    this._clientRoot = await this._withTx("initialization", true, NullResourceId, async (tx) => {
-      let mainRoot: AnyResourceRef;
-
-      if (await tx.checkResourceNameExists(mainRootName))
-        mainRoot = await tx.getResourceByName(mainRootName);
-      else {
-        mainRoot = tx.createRoot(ClientRoot);
-        tx.setResourceName(mainRootName, mainRoot);
+    // Try ListUserResources first (new backend, gRPC only)
+    let rootFromServer: ResourceId | undefined;
+    try {
+      const responses = await this._ll.listUserResources({ limit: 1 });
+      for (const msg of responses) {
+        if (msg.entry.oneofKind === "userRoot") {
+          rootFromServer = bigintToResourceId(msg.entry.userRoot.resourceId);
+          break;
+        }
       }
+    } catch (err) {
+      if (!isUnimplementedError(err)) throw err;
+      // Backend doesn't support ListUserResources — fall through to legacy
+    }
 
+    if (rootFromServer !== undefined) {
+      // New path: server created/returned the root
       if (this.conf.alternativeRoot === undefined) {
-        await tx.commit();
-        return await toGlobalResourceId(mainRoot);
+        this._clientRoot = rootFromServer;
       } else {
-        const aFId = {
-          resourceId: mainRoot,
-          fieldName: alternativeRootFieldName(this.conf.alternativeRoot),
-        };
-
-        const altRoot = tx.createEphemeral(ClientRoot);
-        tx.lock(altRoot);
-        tx.createField(aFId, "Dynamic");
-        tx.setField(aFId, altRoot);
-        await tx.commit();
-
-        return await altRoot.globalId;
+        this._clientRoot = await this._withTx(
+          "initialization",
+          true,
+          rootFromServer,
+          async (tx) => {
+            const aFId = {
+              resourceId: tx.clientRoot,
+              fieldName: alternativeRootFieldName(this.conf.alternativeRoot!),
+            };
+
+            const altRoot = tx.createEphemeral(ClientRoot);
+            tx.lock(altRoot);
+            tx.createField(aFId, "Dynamic");
+            tx.setField(aFId, altRoot);
+            await tx.commit();
+
+            return await altRoot.globalId;
+          },
+        );
       }
-    });
+    } else {
+      // Legacy path: named resource lookup
+      const user = this._ll.authUser;
+      const mainRootName =
+        user === null ? AnonymousClientRoot : createHash("sha256").update(user).digest("hex");
+
+      this._clientRoot = await this._withTx("initialization", true, NullResourceId, async (tx) => {
+        let mainRoot: AnyResourceRef;
+
+        if (await tx.checkResourceNameExists(mainRootName))
+          mainRoot = await tx.getResourceByName(mainRootName);
+        else {
+          mainRoot = tx.createRoot(ClientRoot);
+          tx.setResourceName(mainRootName, mainRoot);
+        }
+
+        if (this.conf.alternativeRoot === undefined) {
+          await tx.commit();
+          return await toGlobalResourceId(mainRoot);
+        } else {
+          const aFId = {
+            resourceId: mainRoot,
+            fieldName: alternativeRootFieldName(this.conf.alternativeRoot),
+          };
+
+          const altRoot = tx.createEphemeral(ClientRoot);
+          tx.lock(altRoot);
+          tx.createField(aFId, "Dynamic");
+          tx.setField(aFId, altRoot);
+          await tx.commit();
+
+          return await altRoot.globalId;
+        }
+      });
+    }
   }
 
   /** Returns true if field existed */

package/src/core/errors.ts

@@ -68,6 +68,17 @@ export function isTimeoutOrCancelError(err: unknown, nested: boolean = false): b
   return false;
 }
 
+export function isUnimplementedError(err: unknown, nested: boolean = false): boolean {
+  if (err === undefined || err === null) return false;
+
+  if ((err as any).name == "RpcError" && (err as any).code == "UNIMPLEMENTED") return true;
+  if ((err as any).name == "RESTError" && (err as any).status.code == Code.UNIMPLEMENTED)
+    return true;
+  if ((err as any).cause !== undefined && !nested)
+    return isUnimplementedError((err as any).cause, true);
+  return false;
+}
+
 export function isNotFoundError(err: unknown, nested: boolean = false): boolean {
   if (err === undefined || err === null) return false;
 

package/src/core/ll_client.test.ts

@@ -142,3 +142,11 @@ test("test https call via proxy", async () => {
   const text = await response.body.text();
   expect(text).toEqual("pong");
 });
+
+test("list user resources returns user root", async () => {
+  const client = await getTestLLClient();
+  const responses = await client.listUserResources({ limit: 1 });
+  expect(responses.length).toBe(1);
+  const msg = responses[0];
+  expect(msg.entry.oneofKind).toBe("userRoot");
+});

package/src/core/ll_client.ts

@@ -35,6 +35,7 @@ import { notEmpty, retry, withTimeout, type RetryOptions } from "@milaboratories
 import { Code } from "../proto-grpc/google/rpc/code";
 import { WebSocketBiDiStream } from "./websocket_stream";
 import {
+  AuthAPI_GetJWTToken_Role,
   TxAPI_ClientMessage,
   TxAPI_ServerMessage,
 } from "../proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api";
@@ -470,13 +471,19 @@ export class LLPlClient implements WireClientProviderFactory {
       const meta: Record<string, string> = {};
       if (options?.authorization) meta.authorization = options.authorization;
       return (
-        await cl.getJWTToken({ expiration: { seconds: ttlSeconds, nanos: 0 } }, { meta }).response
+        await cl.getJWTToken(
+          {
+            expiration: { seconds: ttlSeconds, nanos: 0 },
+            requestedRole: AuthAPI_GetJWTToken_Role.USER,
+          },
+          { meta },
+        ).response
       ).token;
     } else {
       const headers: Record<string, string> = {};
       if (options?.authorization) headers.authorization = options.authorization;
       const resp = cl.POST("/v1/auth/jwt-token", {
-        body: { expiration: `${ttlSeconds}s` },
+        body: { expiration: `${ttlSeconds}s`, requestedRole: AuthAPI_GetJWTToken_Role.USER },
         headers,
       });
       return notEmpty((await resp).data, "REST: empty response for JWT token request").token;
@@ -584,6 +591,27 @@ export class LLPlClient implements WireClientProviderFactory {
     }
   }
 
+  public async listUserResources(
+    opts: { login?: string; startFrom?: bigint; limit?: number } = {},
+  ): Promise<grpcTypes.AuthAPI_ListUserResources_Response[]> {
+    const cl = this.clientProvider.get();
+
+    if (!(cl instanceof GrpcPlApiClient)) {
+      throw new Error("ListUserResources requires gRPC wire protocol; REST is not supported");
+    }
+
+    const call = cl.listUserResources({
+      login: opts.login ?? "",
+      startFrom: opts.startFrom ?? 0n,
+      limit: opts.limit ?? 0,
+    });
+    const responses: grpcTypes.AuthAPI_ListUserResources_Response[] = [];
+    for await (const msg of call.responses) {
+      responses.push(msg);
+    }
+    return responses;
+  }
+
   public async txSync(txId: bigint): Promise<void> {
     const cl = this.clientProvider.get();
     if (cl instanceof GrpcPlApiClient) {

package/src/core/ll_transaction.test.ts

@@ -115,6 +115,7 @@ test("check timeout error type (active)", async () => {
           type: { name: "TestValue", version: "1" },
           data: rData,
           errorIfExists: false,
+          colorProof: new Uint8Array(0),
         },
       },
       false,
@@ -125,7 +126,11 @@ test("check timeout error type (active)", async () => {
       const vr = await tx.send(
         {
           oneofKind: "resourceGet",
-          resourceGet: { resourceId: id, loadFields: false },
+          resourceGet: {
+            resourceId: id,
+            loadFields: false,
+            resourceSignature: new Uint8Array(0),
+          },
         },
         false,
       );
@@ -174,6 +179,7 @@ test("check is abort error (active)", async () => {
           type: { name: "TestValue", version: "1" },
           data: rData,
           errorIfExists: false,
+          colorProof: new Uint8Array(0),
         },
       },
       false,
@@ -184,7 +190,11 @@ test("check is abort error (active)", async () => {
       const vr = await tx.send(
         {
           oneofKind: "resourceGet",
-          resourceGet: { resourceId: id, loadFields: false },
+          resourceGet: {
+            resourceId: id,
+            loadFields: false,
+            resourceSignature: new Uint8Array(0),
+          },
         },
         false,
       );