asma-core-helpers 0.11.0 → 0.13.0

package/lib/helpers/generateEnvConfigsBindings.d.ts

@@ -15,7 +15,7 @@ type IEnvironmentUrls = ReturnType<typeof EnvironmentsUrls1>;
 export type IKeyEnvironmentUrls = keyof IEnvironmentUrls;
 type StartsWith<T, U extends string> = T extends `${U}${infer _}` ? T : never;
 type SRVKeys<T> = {
-    [K in keyof T as StartsWith<K & string, 'SRV_'>]: T[K];
+    [K in keyof T as StartsWith<K & string, 'SRV_'> | StartsWith<K & string, 'HSR_'>]: T[K];
 };
 export type IEnvironmentUrlsGenQLOnly = SRVKeys<IEnvironmentUrls>;
 /**

package/lib/helpers/generateEnvConfigsBindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateEnvConfigsBindings.d.ts","sourceRoot":"","sources":["../../src/helpers/generateEnvConfigsBindings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAGzD,UAAU,SAAS;IACf,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAE/B,2BAA2B,CAAC,EAAE,OAAO,CAAA;IACrC,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,0BAA0B,CAAC,EAAE,OAAO,CAAA;IACpC,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,4BAA4B,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1C;AAED,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE5D,MAAM,MAAM,mBAAmB,GAAG,MAAM,gBAAgB,CAAA;AAExD,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAA;AAE7E,KAAK,OAAO,CAAC,CAAC,IAAI;KACb,CAAC,IAAI,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACzD,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAWjE;;;GAGG;AAEH,wBAAgB,oBAAoB,IAQP;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC7B,GAAG,gBAAgB,GAChB,SAAS,CAChB;AAED,wBAAgB,0BAA0B,CACtC,CAAC,SAAS,SAAS,EACnB,CAAC,SAAS,CACJ,MAAM,CAAC,GACP,OAAO,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CACnD,GACG,MAAM,EACV,CAAC,EACH,WAAW,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,EAAE,aAAa,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgE3F"}
+{"version":3,"file":"generateEnvConfigsBindings.d.ts","sourceRoot":"","sources":["../../src/helpers/generateEnvConfigsBindings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAGzD,UAAU,SAAS;IACf,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAE/B,2BAA2B,CAAC,EAAE,OAAO,CAAA;IACrC,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,0BAA0B,CAAC,EAAE,OAAO,CAAA;IACpC,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,4BAA4B,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1C;AAED,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE5D,MAAM,MAAM,mBAAmB,GAAG,MAAM,gBAAgB,CAAA;AAExD,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAA;AAE7E,KAAK,OAAO,CAAC,CAAC,IAAI;KACb,CAAC,IAAI,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC1F,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAWjE;;;GAGG;AAEH,wBAAgB,oBAAoB,IAQP;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC7B,GAAG,gBAAgB,GAChB,SAAS,CAChB;AAED,wBAAgB,0BAA0B,CACtC,CAAC,SAAS,SAAS,EACnB,CAAC,SAAS,CACJ,MAAM,CAAC,GACP,OAAO,CAAC,mBAAmB,EAAE,gBAAgB,CAAC,CACnD,GACG,MAAM,EACV,CAAC,EACH,WAAW,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,EAAE,aAAa,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgE3F"}

package/lib/helpers/initTadaBrowserClient.d.ts

@@ -0,0 +1,44 @@
+/**
+ * initTadaBrowserClient — high-level, self-contained urql client factory.
+ *
+ * Every ASMA `app-*` family resolves its GraphQL endpoint from the same
+ * EnvConfigs / srv_urls source and authenticates with the same cached JWT, so
+ * that wiring lives here rather than being copy-pasted into each app. Callers
+ * pass the target `service` (and optionally a `path` or service-specific
+ * `resolveExchanges`); URL resolution and JWT binding are handled internally
+ * via the shared `*Internal` bindings — no per-app injection required.
+ *
+ * For the low-level factory that takes an already-resolved URL and explicit
+ * JWT getters, use `createTadaBrowserClient`.
+ *
+ * @see asma-modules/_docs/frontend/operations/2026-07-11-23-00-runbook-graphql-schema-generation-secrets.md
+ */
+import { type ResolveExchanges } from './createTadaBrowserClient.js';
+import { type IEnvironmentUrlsGenQLOnly } from './generateEnvConfigsBindings.js';
+/**
+ * Resolves the GraphQL base URL for a service from EnvConfigs, preferring the
+ * runtime `srv_urls` override (carried in the JWT metadata) for the
+ * consolidated Adopus wrapper and the connector when one is present.
+ */
+export declare function resolveSrvUrl(service: keyof IEnvironmentUrlsGenQLOnly): string;
+export interface InitTadaBrowserClientOptions {
+    /** Target service; its GraphQL URL is resolved via EnvConfigs / srv_urls. */
+    service: keyof IEnvironmentUrlsGenQLOnly;
+    /** GraphQL path appended to the resolved base URL. Defaults to '/v1/graphql'. */
+    path?: string;
+    /** Optional service-specific exchanges (e.g. the Adopus per-tenant namespace rewrite). */
+    resolveExchanges?: ResolveExchanges;
+}
+/**
+ * Creates a configured, authenticated urql Client for an ASMA frontend app
+ * from just a `service` name. URL resolution (`resolveSrvUrl`) and JWT binding
+ * (`getCachedJwtInternal` / `isJwtValidInternal`) are wired internally.
+ */
+export declare function initTadaBrowserClient({ service, path, resolveExchanges }: InitTadaBrowserClientOptions): {
+    getClient: () => Promise<import("@urql/core").Client>;
+    createClient: (opts?: {
+        clientOptions?: Partial<import("@urql/core").ClientOptions>;
+        anonymous?: boolean;
+    }) => Promise<import("@urql/core").Client>;
+};
+//# sourceMappingURL=initTadaBrowserClient.d.ts.map

package/lib/helpers/initTadaBrowserClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initTadaBrowserClient.d.ts","sourceRoot":"","sources":["../../src/helpers/initTadaBrowserClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC7F,OAAO,EAAwB,KAAK,yBAAyB,EAAE,MAAM,iCAAiC,CAAA;AAGtG;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,yBAAyB,GAAG,MAAM,CAqB9E;AAED,MAAM,WAAW,4BAA4B;IACzC,6EAA6E;IAC7E,OAAO,EAAE,MAAM,yBAAyB,CAAA;IACxC,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACtC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,OAAO,EAAE,IAAoB,EAAE,gBAAgB,EAAE,EAAE,4BAA4B;;uBAF3E,CAAC;qBAAiB,CAAC;iBAE1C,CAAC;;EAOrB"}

package/lib/helpers/initTadaBrowserClient.js

@@ -0,0 +1,56 @@
+/**
+ * initTadaBrowserClient — high-level, self-contained urql client factory.
+ *
+ * Every ASMA `app-*` family resolves its GraphQL endpoint from the same
+ * EnvConfigs / srv_urls source and authenticates with the same cached JWT, so
+ * that wiring lives here rather than being copy-pasted into each app. Callers
+ * pass the target `service` (and optionally a `path` or service-specific
+ * `resolveExchanges`); URL resolution and JWT binding are handled internally
+ * via the shared `*Internal` bindings — no per-app injection required.
+ *
+ * For the low-level factory that takes an already-resolved URL and explicit
+ * JWT getters, use `createTadaBrowserClient`.
+ *
+ * @see asma-modules/_docs/frontend/operations/2026-07-11-23-00-runbook-graphql-schema-generation-secrets.md
+ */
+import { createTadaBrowserClient } from './createTadaBrowserClient.js';
+import { EnvConfigsFnInternal } from './generateEnvConfigsBindings.js';
+import { getCachedJwtInternal, getSrvUrlsInternal, isJwtValidInternal } from './generateSrvAuthBindings.js';
+/**
+ * Resolves the GraphQL base URL for a service from EnvConfigs, preferring the
+ * runtime `srv_urls` override (carried in the JWT metadata) for the
+ * consolidated Adopus wrapper and the connector when one is present.
+ */
+export function resolveSrvUrl(service) {
+    let service_url = EnvConfigsFnInternal()[service];
+    if (service === 'HSR_AO_WRAPPER') {
+        const url = getSrvUrlsInternal()?.ao_wrapper;
+        if (url) {
+            service_url = url;
+        }
+    }
+    else if (service === 'SRV_CONNECTOR') {
+        const url = getSrvUrlsInternal()?.connector;
+        if (url) {
+            service_url = url;
+        }
+    }
+    if (!service_url) {
+        throw Error(`'required param serviceUrl() is undefined, please check EnvConfig object!', service: ${service}`);
+    }
+    return service_url;
+}
+/**
+ * Creates a configured, authenticated urql Client for an ASMA frontend app
+ * from just a `service` name. URL resolution (`resolveSrvUrl`) and JWT binding
+ * (`getCachedJwtInternal` / `isJwtValidInternal`) are wired internally.
+ */
+export function initTadaBrowserClient({ service, path = '/v1/graphql', resolveExchanges }) {
+    return createTadaBrowserClient({
+        url: `${resolveSrvUrl(service)}${path}`,
+        getJwt: getCachedJwtInternal,
+        isJwtValid: isJwtValidInternal,
+        resolveExchanges,
+    });
+}
+//# sourceMappingURL=initTadaBrowserClient.js.map

package/lib/helpers/initTadaBrowserClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initTadaBrowserClient.js","sourceRoot":"","sources":["../../src/helpers/initTadaBrowserClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,uBAAuB,EAAyB,MAAM,8BAA8B,CAAA;AAC7F,OAAO,EAAE,oBAAoB,EAAkC,MAAM,iCAAiC,CAAA;AACtG,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAE3G;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAwC;IAClE,IAAI,WAAW,GAAG,oBAAoB,EAAE,CAAC,OAAO,CAAC,CAAA;IAEjD,IAAI,OAAO,KAAK,gBAAgB,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,kBAAkB,EAAE,EAAE,UAAU,CAAA;QAC5C,IAAI,GAAG,EAAE,CAAC;YACN,WAAW,GAAG,GAAG,CAAA;QACrB,CAAC;IACL,CAAC;SAAM,IAAI,OAAO,KAAK,eAAe,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,kBAAkB,EAAE,EAAE,SAAS,CAAA;QAC3C,IAAI,GAAG,EAAE,CAAC;YACN,WAAW,GAAG,GAAG,CAAA;QACrB,CAAC;IACL,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,MAAM,KAAK,CACP,wFAAwF,OAAO,EAAE,CACpG,CAAA;IACL,CAAC;IACD,OAAO,WAAW,CAAA;AACtB,CAAC;AAWD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAE,OAAO,EAAE,IAAI,GAAG,aAAa,EAAE,gBAAgB,EAAgC;IACnH,OAAO,uBAAuB,CAAC;QAC3B,GAAG,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE;QACvC,MAAM,EAAE,oBAAoB;QAC5B,UAAU,EAAE,kBAAkB;QAC9B,gBAAgB;KACnB,CAAC,CAAA;AACN,CAAC"}

package/lib/helpers/urql.d.ts

@@ -1,4 +1,6 @@
 export { adopusNamespaceExchange, adopusSlugFromJwt, denamespaceData, namespaceDocument } from './adopusNamespaceExchange.js';
 export { createTadaBrowserClient } from './createTadaBrowserClient.js';
 export type { CreateTadaBrowserClientOptions, ResolveExchanges } from './createTadaBrowserClient.js';
+export { initTadaBrowserClient, resolveSrvUrl } from './initTadaBrowserClient.js';
+export type { InitTadaBrowserClientOptions } from './initTadaBrowserClient.js';
 //# sourceMappingURL=urql.d.ts.map

package/lib/helpers/urql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"urql.d.ts","sourceRoot":"","sources":["../../src/helpers/urql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAC7H,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,YAAY,EAAE,8BAA8B,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA"}
+{"version":3,"file":"urql.d.ts","sourceRoot":"","sources":["../../src/helpers/urql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAC7H,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,YAAY,EAAE,8BAA8B,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AACpG,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AACjF,YAAY,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA"}

package/lib/helpers/urql.js

@@ -1,3 +1,4 @@
 export { adopusNamespaceExchange, adopusSlugFromJwt, denamespaceData, namespaceDocument } from './adopusNamespaceExchange.js';
 export { createTadaBrowserClient } from './createTadaBrowserClient.js';
+export { initTadaBrowserClient, resolveSrvUrl } from './initTadaBrowserClient.js';
 //# sourceMappingURL=urql.js.map

package/lib/helpers/urql.js.map

@@ -1 +1 @@
-{"version":3,"file":"urql.js","sourceRoot":"","sources":["../../src/helpers/urql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAC7H,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA"}
+{"version":3,"file":"urql.js","sourceRoot":"","sources":["../../src/helpers/urql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAC7H,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAEtE,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA"}

package/lib/index.d.ts

@@ -41,4 +41,6 @@ export * from './helpers/getActivityStatus.js';
 export * from './helpers/stringToKeyValueMap.js';
 export { createTadaBrowserClient } from './helpers/createTadaBrowserClient.js';
 export type { CreateTadaBrowserClientOptions, ResolveExchanges } from './helpers/createTadaBrowserClient.js';
+export { initTadaBrowserClient, resolveSrvUrl } from './helpers/initTadaBrowserClient.js';
+export type { InitTadaBrowserClientOptions } from './helpers/initTadaBrowserClient.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA;AAChD,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,mCAAmC,CAAA;AACjD,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mDAAmD,CAAA;AACjE,cAAc,iCAAiC,CAAA;AAE/C,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,wCAAwC,CAAA;AACtD,cAAc,sCAAsC,CAAA;AACpD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,2BAA2B,CAAA;AACzC,cAAc,2CAA2C,CAAA;AACzD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,yCAAyC,CAAA;AACvD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA;AACvC,cAAc,2CAA2C,CAAA;AACzD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,+BAA+B,CAAA;AAE7C,cAAc,qBAAqB,CAAA;AACnC,cAAc,kCAAkC,CAAA;AAEhD,cAAc,oBAAoB,CAAA;AAElC,cAAc,sBAAsB,CAAA;AAEpC,cAAc,uBAAuB,CAAA;AAErC,cAAc,oBAAoB,CAAA;AAElC,cAAc,8CAA8C,CAAA;AAC5D,cAAc,+CAA+C,CAAA;AAC7D,cAAc,mCAAmC,CAAA;AACjD,cAAc,qBAAqB,CAAA;AACnC,cAAc,uCAAuC,CAAA;AACrD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAEhD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AAC9E,YAAY,EAAE,8BAA8B,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA;AAChD,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,mCAAmC,CAAA;AACjD,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mDAAmD,CAAA;AACjE,cAAc,iCAAiC,CAAA;AAE/C,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,wCAAwC,CAAA;AACtD,cAAc,sCAAsC,CAAA;AACpD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,2BAA2B,CAAA;AACzC,cAAc,2CAA2C,CAAA;AACzD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,yCAAyC,CAAA;AACvD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA;AACvC,cAAc,2CAA2C,CAAA;AACzD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,+BAA+B,CAAA;AAE7C,cAAc,qBAAqB,CAAA;AACnC,cAAc,kCAAkC,CAAA;AAEhD,cAAc,oBAAoB,CAAA;AAElC,cAAc,sBAAsB,CAAA;AAEpC,cAAc,uBAAuB,CAAA;AAErC,cAAc,oBAAoB,CAAA;AAElC,cAAc,8CAA8C,CAAA;AAC5D,cAAc,+CAA+C,CAAA;AAC7D,cAAc,mCAAmC,CAAA;AACjD,cAAc,qBAAqB,CAAA;AACnC,cAAc,uCAAuC,CAAA;AACrD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAEhD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AAC9E,YAAY,EAAE,8BAA8B,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAA;AAC5G,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAA;AACzF,YAAY,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAA"}

package/lib/index.js

@@ -41,4 +41,5 @@ export * from './helpers/JSONToBase64EncodeDecode.js';
 export * from './helpers/getActivityStatus.js';
 export * from './helpers/stringToKeyValueMap.js';
 export { createTadaBrowserClient } from './helpers/createTadaBrowserClient.js';
+export { initTadaBrowserClient, resolveSrvUrl } from './helpers/initTadaBrowserClient.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA;AAChD,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,mCAAmC,CAAA;AACjD,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mDAAmD,CAAA;AACjE,cAAc,iCAAiC,CAAA;AAE/C,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,wCAAwC,CAAA;AACtD,cAAc,sCAAsC,CAAA;AACpD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,2BAA2B,CAAA;AACzC,cAAc,2CAA2C,CAAA;AACzD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,yCAAyC,CAAA;AACvD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA;AACvC,cAAc,2CAA2C,CAAA;AACzD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,+BAA+B,CAAA;AAC7C,gDAAgD;AAChD,cAAc,qBAAqB,CAAA;AACnC,cAAc,kCAAkC,CAAA;AAEhD,cAAc,oBAAoB,CAAA;AAElC,cAAc,sBAAsB,CAAA;AAEpC,cAAc,uBAAuB,CAAA;AAErC,cAAc,oBAAoB,CAAA;AAElC,cAAc,8CAA8C,CAAA;AAC5D,cAAc,+CAA+C,CAAA;AAC7D,cAAc,mCAAmC,CAAA;AACjD,cAAc,qBAAqB,CAAA;AACnC,cAAc,uCAAuC,CAAA;AACrD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAEhD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA;AAChD,cAAc,oCAAoC,CAAA;AAClD,cAAc,mCAAmC,CAAA;AACjD,cAAc,mCAAmC,CAAA;AACjD,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mDAAmD,CAAA;AACjE,cAAc,iCAAiC,CAAA;AAE/C,cAAc,kCAAkC,CAAA;AAChD,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,wCAAwC,CAAA;AACtD,cAAc,sCAAsC,CAAA;AACpD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,2BAA2B,CAAA;AACzC,cAAc,2CAA2C,CAAA;AACzD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,yCAAyC,CAAA;AACvD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA;AACvC,cAAc,2CAA2C,CAAA;AACzD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,+BAA+B,CAAA;AAC7C,gDAAgD;AAChD,cAAc,qBAAqB,CAAA;AACnC,cAAc,kCAAkC,CAAA;AAEhD,cAAc,oBAAoB,CAAA;AAElC,cAAc,sBAAsB,CAAA;AAEpC,cAAc,uBAAuB,CAAA;AAErC,cAAc,oBAAoB,CAAA;AAElC,cAAc,8CAA8C,CAAA;AAC5D,cAAc,+CAA+C,CAAA;AAC7D,cAAc,mCAAmC,CAAA;AACjD,cAAc,qBAAqB,CAAA;AACnC,cAAc,uCAAuC,CAAA;AACrD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,kCAAkC,CAAA;AAEhD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AAE9E,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "asma-core-helpers",
-    "version": "0.11.0",
+    "version": "0.13.0",
     "description": "Core helper utilities for ASMA applications",
     "files": [
         "lib/**/*",

package/src/helpers/generateEnvConfigsBindings.ts

@@ -25,7 +25,7 @@ export type IKeyEnvironmentUrls = keyof IEnvironmentUrls
 type StartsWith<T, U extends string> = T extends `${U}${infer _}` ? T : never
 
 type SRVKeys<T> = {
-    [K in keyof T as StartsWith<K & string, 'SRV_'>]: T[K]
+    [K in keyof T as StartsWith<K & string, 'SRV_'> | StartsWith<K & string, 'HSR_'>]: T[K]
 }
 
 export type IEnvironmentUrlsGenQLOnly = SRVKeys<IEnvironmentUrls> /* Omit<

package/src/helpers/initTadaBrowserClient.ts

@@ -0,0 +1,69 @@
+/**
+ * initTadaBrowserClient — high-level, self-contained urql client factory.
+ *
+ * Every ASMA `app-*` family resolves its GraphQL endpoint from the same
+ * EnvConfigs / srv_urls source and authenticates with the same cached JWT, so
+ * that wiring lives here rather than being copy-pasted into each app. Callers
+ * pass the target `service` (and optionally a `path` or service-specific
+ * `resolveExchanges`); URL resolution and JWT binding are handled internally
+ * via the shared `*Internal` bindings — no per-app injection required.
+ *
+ * For the low-level factory that takes an already-resolved URL and explicit
+ * JWT getters, use `createTadaBrowserClient`.
+ *
+ * @see asma-modules/_docs/frontend/operations/2026-07-11-23-00-runbook-graphql-schema-generation-secrets.md
+ */
+import { createTadaBrowserClient, type ResolveExchanges } from './createTadaBrowserClient.js'
+import { EnvConfigsFnInternal, type IEnvironmentUrlsGenQLOnly } from './generateEnvConfigsBindings.js'
+import { getCachedJwtInternal, getSrvUrlsInternal, isJwtValidInternal } from './generateSrvAuthBindings.js'
+
+/**
+ * Resolves the GraphQL base URL for a service from EnvConfigs, preferring the
+ * runtime `srv_urls` override (carried in the JWT metadata) for the
+ * consolidated Adopus wrapper and the connector when one is present.
+ */
+export function resolveSrvUrl(service: keyof IEnvironmentUrlsGenQLOnly): string {
+    let service_url = EnvConfigsFnInternal()[service]
+
+    if (service === 'HSR_AO_WRAPPER') {
+        const url = getSrvUrlsInternal()?.ao_wrapper
+        if (url) {
+            service_url = url
+        }
+    } else if (service === 'SRV_CONNECTOR') {
+        const url = getSrvUrlsInternal()?.connector
+        if (url) {
+            service_url = url
+        }
+    }
+
+    if (!service_url) {
+        throw Error(
+            `'required param serviceUrl() is undefined, please check EnvConfig object!', service: ${service}`,
+        )
+    }
+    return service_url
+}
+
+export interface InitTadaBrowserClientOptions {
+    /** Target service; its GraphQL URL is resolved via EnvConfigs / srv_urls. */
+    service: keyof IEnvironmentUrlsGenQLOnly
+    /** GraphQL path appended to the resolved base URL. Defaults to '/v1/graphql'. */
+    path?: string
+    /** Optional service-specific exchanges (e.g. the Adopus per-tenant namespace rewrite). */
+    resolveExchanges?: ResolveExchanges
+}
+
+/**
+ * Creates a configured, authenticated urql Client for an ASMA frontend app
+ * from just a `service` name. URL resolution (`resolveSrvUrl`) and JWT binding
+ * (`getCachedJwtInternal` / `isJwtValidInternal`) are wired internally.
+ */
+export function initTadaBrowserClient({ service, path = '/v1/graphql', resolveExchanges }: InitTadaBrowserClientOptions) {
+    return createTadaBrowserClient({
+        url: `${resolveSrvUrl(service)}${path}`,
+        getJwt: getCachedJwtInternal,
+        isJwtValid: isJwtValidInternal,
+        resolveExchanges,
+    })
+}

package/src/helpers/urql.ts

@@ -1,3 +1,5 @@
 export { adopusNamespaceExchange, adopusSlugFromJwt, denamespaceData, namespaceDocument } from './adopusNamespaceExchange.js'
 export { createTadaBrowserClient } from './createTadaBrowserClient.js'
 export type { CreateTadaBrowserClientOptions, ResolveExchanges } from './createTadaBrowserClient.js'
+export { initTadaBrowserClient, resolveSrvUrl } from './initTadaBrowserClient.js'
+export type { InitTadaBrowserClientOptions } from './initTadaBrowserClient.js'

package/src/index.ts

@@ -49,3 +49,5 @@ export * from './helpers/stringToKeyValueMap.js'
 
 export { createTadaBrowserClient } from './helpers/createTadaBrowserClient.js'
 export type { CreateTadaBrowserClientOptions, ResolveExchanges } from './helpers/createTadaBrowserClient.js'
+export { initTadaBrowserClient, resolveSrvUrl } from './helpers/initTadaBrowserClient.js'
+export type { InitTadaBrowserClientOptions } from './helpers/initTadaBrowserClient.js'