asma-core-helpers 0.8.0 → 0.9.0

package/lib/helpers/adopusNamespaceExchange.d.ts

@@ -0,0 +1,44 @@
+/**
+ * adopusNamespaceExchange — urql exchange that maps unprefixed gql.tada operations onto the
+ * consolidated Adopus Hasura engine's per-tenant namespace, at the wire level only.
+ *
+ * Compile-time types stay the unprefixed avansas/AdOpusTest schema (DEC-004/DEC-011); this
+ * exchange rewrites the parsed document + JSON per request/response:
+ *   1. request:  wrap each operation's selection set in the `<slug>` root field
+ *   2. request:  prefix schema type names in variable definitions (`Actor_bool_exp` -> `<slug>_Actor_bool_exp`)
+ *   3. request:  prefix fragment type conditions (inline + named)
+ *   4. response: unwrap `data[<slug>]` -> `data`
+ *   5. response: strip the `<slug>_` prefix from `__typename` values
+ *
+ * `prefixedTypes` is the exact set of names the engine prefixes for the tenant source —
+ * generated at codegen time by adopus-hsr-wrapper/scripts/unwrap_client_schema.mjs
+ * (adopus-prefixed-types.json) so the runtime never guesses which names carry the prefix.
+ *
+ * Install it only on the SRV_AO_WRAPPER client and only when the resolved endpoint is the
+ * consolidated engine (`/api/hsr-wrapper/`) — the per-tenant `srv_urls.ao_wrapper` flip then
+ * switches endpoint and namespace mode atomically.
+ *
+ * @see asma-modules/_docs/adopus-graphql/plans/2026-07-11-00-14-plan-adopus-hasura2-consolidation.md:184 — §2.4.3 (DEC-004/DEC-015)
+ */
+import type { DocumentNode } from '@0no-co/graphql.web';
+import { type Exchange } from '@urql/core';
+/**
+ * Derive the tenant namespace slug from the main ASMA JWT's `subdomain` claim (DEC-015),
+ * sanitized per plan §1.1 (lowercase, hyphens -> underscores). Returns undefined when the
+ * token is missing or the claim does not sanitize to a valid slug — callers skip the
+ * exchange in that case.
+ */
+export declare function adopusSlugFromJwt(jwt: string | undefined): string | undefined;
+/** Transforms 1–3 on the parsed operation document. Pure; exported for tests. */
+export declare function namespaceDocument(document: DocumentNode, slug: string, prefixed: ReadonlySet<string>): DocumentNode;
+/** Transforms 4–5 on the response payload. Pure (returns new objects); exported for tests. */
+export declare function denamespaceData<T>(data: T, slug: string): T;
+/**
+ * @param slug tenant namespace — derive with `adopusSlugFromJwt(await getCachedJwt())`
+ * @param prefixedTypes contents of the codegen-emitted `adopus-prefixed-types.json`
+ */
+export declare function adopusNamespaceExchange({ slug, prefixedTypes, }: {
+    slug: string;
+    prefixedTypes: readonly string[];
+}): Exchange;
+//# sourceMappingURL=adopusNamespaceExchange.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adopusNamespaceExchange.d.ts","sourceRoot":"","sources":["../../src/helpers/adopusNamespaceExchange.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAiB,KAAK,QAAQ,EAAwC,MAAM,YAAY,CAAA;AAgE/F;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAS7E;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,YAAY,CAsDnH;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAM3D;AAYD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EACpC,IAAI,EACJ,aAAa,GAChB,EAAE;IACC,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC,GAAG,QAAQ,CAwBX"}

package/lib/helpers/adopusNamespaceExchange.js

@@ -0,0 +1,126 @@
+import { makeOperation } from '@urql/core';
+import { map, pipe } from 'wonka';
+const SLUG_PATTERN = /^[a-z][a-z0-9_]{1,30}$/;
+// not parseJwt.js — that module touches `window` at import time; this subpath stays environment-neutral
+function decodeJwtClaims(jwt) {
+    const payload = jwt.split('.')[1];
+    if (!payload)
+        return undefined;
+    try {
+        const base64 = payload.replace(/-/g, '+').replace(/_/g, '/');
+        return JSON.parse(new TextDecoder().decode(Uint8Array.from(atob(base64), (c) => c.charCodeAt(0))));
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Derive the tenant namespace slug from the main ASMA JWT's `subdomain` claim (DEC-015),
+ * sanitized per plan §1.1 (lowercase, hyphens -> underscores). Returns undefined when the
+ * token is missing or the claim does not sanitize to a valid slug — callers skip the
+ * exchange in that case.
+ */
+export function adopusSlugFromJwt(jwt) {
+    if (!jwt)
+        return undefined;
+    const claims = decodeJwtClaims(jwt);
+    const slug = claims?.subdomain?.toLowerCase().replace(/-/g, '_');
+    if (!slug || !SLUG_PATTERN.test(slug)) {
+        console.error(`adopusSlugFromJwt: subdomain claim '${claims?.subdomain}' is not a valid namespace slug`);
+        return undefined;
+    }
+    return slug;
+}
+/** Transforms 1–3 on the parsed operation document. Pure; exported for tests. */
+export function namespaceDocument(document, slug, prefixed) {
+    const doc = document;
+    const prefixName = (name) => prefixed.has(name.value) ? { ...name, value: `${slug}_${name.value}` } : name;
+    const prefixType = (type) => type.kind === 'NamedType' ? { ...type, name: prefixName(type.name) } : { ...type, type: prefixType(type.type) };
+    const prefixFragmentConditions = (selectionSet) => ({
+        ...selectionSet,
+        selections: selectionSet.selections.map((sel) => {
+            if (sel.kind === 'InlineFragment') {
+                return {
+                    ...sel,
+                    typeCondition: sel.typeCondition && { ...sel.typeCondition, name: prefixName(sel.typeCondition.name) },
+                    selectionSet: prefixFragmentConditions(sel.selectionSet),
+                };
+            }
+            if (sel.kind === 'Field' && sel.selectionSet) {
+                return { ...sel, selectionSet: prefixFragmentConditions(sel.selectionSet) };
+            }
+            return sel;
+        }),
+    });
+    const out = {
+        ...doc,
+        definitions: doc.definitions.map((def) => {
+            if (def.kind === 'OperationDefinition') {
+                const op = def;
+                const namespaceField = {
+                    kind: 'Field',
+                    name: { kind: 'Name', value: slug },
+                    selectionSet: prefixFragmentConditions(op.selectionSet),
+                };
+                return {
+                    ...op,
+                    variableDefinitions: op.variableDefinitions?.map((v) => ({ ...v, type: prefixType(v.type) })),
+                    selectionSet: { kind: 'SelectionSet', selections: [namespaceField] },
+                };
+            }
+            if (def.kind === 'FragmentDefinition') {
+                const frag = def;
+                return {
+                    ...frag,
+                    typeCondition: { ...frag.typeCondition, name: prefixName(frag.typeCondition.name) },
+                    selectionSet: prefixFragmentConditions(frag.selectionSet),
+                };
+            }
+            return def;
+        }),
+    };
+    return out;
+}
+/** Transforms 4–5 on the response payload. Pure (returns new objects); exported for tests. */
+export function denamespaceData(data, slug) {
+    const unwrapped = data && typeof data === 'object' && !Array.isArray(data) && slug in data
+        ? data[slug]
+        : data;
+    return stripTypenamePrefix(unwrapped, `${slug}_`);
+}
+function stripTypenamePrefix(value, prefix) {
+    if (Array.isArray(value))
+        return value.map((v) => stripTypenamePrefix(v, prefix));
+    if (!value || typeof value !== 'object')
+        return value;
+    const out = {};
+    for (const [key, v] of Object.entries(value)) {
+        out[key] = key === '__typename' && typeof v === 'string' && v.startsWith(prefix) ? v.slice(prefix.length) : stripTypenamePrefix(v, prefix);
+    }
+    return out;
+}
+/**
+ * @param slug tenant namespace — derive with `adopusSlugFromJwt(await getCachedJwt())`
+ * @param prefixedTypes contents of the codegen-emitted `adopus-prefixed-types.json`
+ */
+export function adopusNamespaceExchange({ slug, prefixedTypes, }) {
+    const prefixed = new Set(prefixedTypes);
+    // documents are module-level gql.tada constants — stable references, so WeakMap memoizes
+    // the rewrite once per document (NOT per operation.key, which varies with variables)
+    const rewritten = new WeakMap();
+    const rewriteOperation = (op) => {
+        if (op.kind === 'teardown')
+            return op;
+        let query = rewritten.get(op.query);
+        if (!query) {
+            query = namespaceDocument(op.query, slug, prefixed);
+            rewritten.set(op.query, query);
+        }
+        return makeOperation(op.kind, { ...op, query }, op.context);
+    };
+    const rewriteResult = (result) => result.operation.kind === 'teardown' || result.data == null
+        ? result // ponytail: error paths keep the <slug> segment — cosmetic, fix if it ever confuses anyone
+        : { ...result, data: denamespaceData(result.data, slug) };
+    return ({ forward }) => (ops$) => pipe(forward(pipe(ops$, map(rewriteOperation))), map(rewriteResult));
+}
+//# sourceMappingURL=adopusNamespaceExchange.js.map

package/lib/helpers/adopusNamespaceExchange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopusNamespaceExchange.js","sourceRoot":"","sources":["../../src/helpers/adopusNamespaceExchange.ts"],"names":[],"mappings":"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"}

package/lib/helpers/generateSrvAuthBindings.d.ts

@@ -1,13 +1,13 @@
 import type { ICheckSigninOptions, ICheckSigninTransformedOptions } from './generateSrvAuthBindings.types.js';
 import { type ActivityStatus, type IAuthBindings } from '../index.js';
 import type { IUUID } from 'asma-types';
-export declare const dispatchSrvAuthEvents: <Key extends "logout_event" | "jwt_changed" | "customer_changed">(event: Key, arg: {
+export declare const dispatchSrvAuthEvents: <Key extends "jwt_changed" | "logout_event" | "customer_changed">(event: Key, arg: {
     jwt_changed?: ICheckSigninOptions<any>;
     logout_event: {
         device?: "TRUSTED" | "UNTRUSTED";
     };
     customer_changed: {};
-}[Key], shouldPersist?: boolean) => void, registerCallbackOnSrvAuthEvents: <Key extends "logout_event" | "jwt_changed" | "customer_changed">(event: Key, callback: (val: {
+}[Key], shouldPersist?: boolean) => void, registerCallbackOnSrvAuthEvents: <Key extends "jwt_changed" | "logout_event" | "customer_changed">(event: Key, callback: (val: {
     jwt_changed?: ICheckSigninOptions<any>;
     logout_event: {
         device?: "TRUSTED" | "UNTRUSTED";
@@ -18,8 +18,8 @@ export declare const dispatchSrvAuthEvents: <Key extends "logout_event" | "jwt_c
 };
 declare function dispatchLogoutEvent(device?: 'TRUSTED' | 'UNTRUSTED'): void;
 /**
- * @generic FeatureEnums - feature_names_enums from asma-genql-directory
- * @generic SrvUrlsEnums - srv_names_enums from asma-genql-directory
+ * @generic FeatureEnums - feature_names_enums from directory introspection
+ * @generic SrvUrlsEnums - srv_names_enums from directory introspection
  */
 export declare function getCachedJwtInternal(): Promise<string | undefined>;
 export declare function checkForRegisteredSubdomainInternal(): Promise<ICheckRegisteredSubdomainResponse<any> | undefined>;
@@ -89,7 +89,7 @@ export declare function generateSrvAuthBindings<FE extends string>(logout?: () =
     /**
      * @deprecated use registerCallbackOnSrvAuthEvents directly
      */
-    registerOnJwtChanges: <Key extends "logout_event" | "jwt_changed" | "customer_changed">(event: Key, callback: (val: {
+    registerOnJwtChanges: <Key extends "jwt_changed" | "logout_event" | "customer_changed">(event: Key, callback: (val: {
         jwt_changed?: ICheckSigninOptions<any>;
         logout_event: {
             device?: "TRUSTED" | "UNTRUSTED";
@@ -98,7 +98,7 @@ export declare function generateSrvAuthBindings<FE extends string>(logout?: () =
     }[Key]) => void) => {
         unregister: () => void;
     };
-    registerCallbackOnSrvAuthEvents: <Key extends "logout_event" | "jwt_changed" | "customer_changed">(event: Key, callback: (val: {
+    registerCallbackOnSrvAuthEvents: <Key extends "jwt_changed" | "logout_event" | "customer_changed">(event: Key, callback: (val: {
         jwt_changed?: ICheckSigninOptions<any>;
         logout_event: {
             device?: "TRUSTED" | "UNTRUSTED";
@@ -177,7 +177,7 @@ export declare function generateSrvAuthBindingsMicroApp(logout?: () => void): IA
     /**
      * @deprecated use registerCallbackOnSrvAuthEvents directly
      */
-    registerOnJwtChanges: <Key extends "logout_event" | "jwt_changed" | "customer_changed">(event: Key, callback: (val: {
+    registerOnJwtChanges: <Key extends "jwt_changed" | "logout_event" | "customer_changed">(event: Key, callback: (val: {
         jwt_changed?: ICheckSigninOptions<any>;
         logout_event: {
             device?: "TRUSTED" | "UNTRUSTED";
@@ -186,7 +186,7 @@ export declare function generateSrvAuthBindingsMicroApp(logout?: () => void): IA
     }[Key]) => void) => {
         unregister: () => void;
     };
-    registerCallbackOnSrvAuthEvents: <Key extends "logout_event" | "jwt_changed" | "customer_changed">(event: Key, callback: (val: {
+    registerCallbackOnSrvAuthEvents: <Key extends "jwt_changed" | "logout_event" | "customer_changed">(event: Key, callback: (val: {
         jwt_changed?: ICheckSigninOptions<any>;
         logout_event: {
             device?: "TRUSTED" | "UNTRUSTED";

package/lib/helpers/generateSrvAuthBindings.js

@@ -14,8 +14,8 @@ function dispatchJwtChangedEvent(jwt) {
     dispatchSrvAuthEvents('jwt_changed', jwt, false);
 }
 /**
- * @generic FeatureEnums - feature_names_enums from asma-genql-directory
- * @generic SrvUrlsEnums - srv_names_enums from asma-genql-directory
+ * @generic FeatureEnums - feature_names_enums from directory introspection
+ * @generic SrvUrlsEnums - srv_names_enums from directory introspection
  */
 //type EnvConfigsFn = () => { SRV_AUTH: string; DEVELOPMENT: boolean; ENVIRONMENT_TO_OPERATE: string }
 export async function getCachedJwtInternal() {

package/lib/index.d.ts

@@ -17,7 +17,6 @@ export * from './helpers/generateSrvAuthBindings.types.js';
 export * from './helpers/getSubdomain.js';
 export * from './helpers/checkForRegisteredSubdomains.js';
 export * from './helpers/clearCacheData.js';
-export * from './helpers/generateGenqlClient.js';
 export * from './helpers/generateEnvConfigsBindings.js';
 export * from './helpers/userTypingSignal.js';
 export * from './helpers/base64ToFile.js';

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,kCAAkC,CAAA;AAChD,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"}
+{"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"}

package/lib/index.js

@@ -17,7 +17,6 @@ export * from './helpers/generateSrvAuthBindings.types.js';
 export * from './helpers/getSubdomain.js';
 export * from './helpers/checkForRegisteredSubdomains.js';
 export * from './helpers/clearCacheData.js';
-export * from './helpers/generateGenqlClient.js';
 export * from './helpers/generateEnvConfigsBindings.js';
 export * from './helpers/userTypingSignal.js';
 export * from './helpers/base64ToFile.js';

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,kCAAkC,CAAA;AAChD,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"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "asma-core-helpers",
-    "version": "0.8.0",
+    "version": "0.9.0",
     "description": "Core helper utilities for ASMA applications",
     "files": [
         "lib/**/*",
@@ -10,7 +10,11 @@
     "type": "module",
     "exports": {
         ".": "./lib/index.js",
-        "./lib": "./lib/index.js"
+        "./lib": "./lib/index.js",
+        "./urql": {
+            "types": "./lib/helpers/adopusNamespaceExchange.d.ts",
+            "default": "./lib/helpers/adopusNamespaceExchange.js"
+        }
     },
     "scripts": {
         "build": "npx tsc && npx tsc -p .",
@@ -23,16 +27,31 @@
     "keywords": [],
     "author": "",
     "license": "MIT",
+    "peerDependencies": {
+        "@urql/core": ">=4",
+        "wonka": ">=6"
+    },
+    "peerDependenciesMeta": {
+        "@urql/core": {
+            "optional": true
+        },
+        "wonka": {
+            "optional": true
+        }
+    },
     "devDependencies": {
-        "@genql/runtime": "^2.10.0",
         "@openreplay/tracker": "^16.4.10",
+        "@urql/core": "^6.0.3",
         "asma-qiankun-react-loader": "^0.8.2",
         "asma-types": "^2.8.0",
         "history": "^5.3.0",
         "lefthook": "^2.1.1",
-        "typescript": "^5.6.3"
+        "tsx": "^4.23.0",
+        "typescript": "^5.6.3",
+        "wonka": "^6.3.4"
     },
     "dependencies": {
+        "@0no-co/graphql.web": "^1.0.9",
         "asma-event-bus": "^0.7.27",
         "buffer": "^6.0.3",
         "idb-keyval": "^6.2.1",

package/src/helpers/adopusNamespaceExchange.test.ts

@@ -0,0 +1,117 @@
+import assert from 'node:assert/strict'
+import { describe, it } from 'node:test'
+
+import { parse, print } from '@0no-co/graphql.web'
+
+import { adopusSlugFromJwt, denamespaceData, namespaceDocument } from './adopusNamespaceExchange.js'
+
+const PREFIXED = new Set(['Actor', 'Actor_bool_exp', 'Int_comparison_exp', 'uniqueidentifier'])
+
+const normalize = (sdl: string) => print(parse(sdl))
+
+describe('namespaceDocument (transforms 1-3)', () => {
+    it('wraps the operation, prefixes variable definition types, leaves builtins alone', () => {
+        const doc = parse(`
+            query fetchActors($where: Actor_bool_exp, $limit: Int, $id: uniqueidentifier) {
+                Actor(where: $where, limit: $limit) { ActorNo Navn }
+            }
+        `)
+        const out = print(namespaceDocument(doc, 'avansas', PREFIXED))
+        assert.equal(
+            out,
+            normalize(`
+                query fetchActors($where: avansas_Actor_bool_exp, $limit: Int, $id: avansas_uniqueidentifier) {
+                    avansas {
+                        Actor(where: $where, limit: $limit) { ActorNo Navn }
+                    }
+                }
+            `),
+        )
+    })
+
+    it('prefixes wrapped list/non-null variable types', () => {
+        const doc = parse(`query q($ids: [Int_comparison_exp!]!) { Actor { ActorNo } }`)
+        const out = print(namespaceDocument(doc, 'avansas', PREFIXED))
+        assert.match(out, /\$ids: \[avansas_Int_comparison_exp!\]!/)
+    })
+
+    it('prefixes inline and named fragment type conditions, at any depth', () => {
+        const doc = parse(`
+            query q {
+                Actor {
+                    ... on Actor { ActorNo }
+                    ActorActor_Overordnet { ... on Actor { Navn } }
+                    ...actorFields
+                }
+            }
+            fragment actorFields on Actor { Navn }
+        `)
+        const out = print(namespaceDocument(doc, 'avansas', PREFIXED))
+        assert.equal((out.match(/on avansas_Actor/g) ?? []).length, 3)
+        assert.doesNotMatch(out, /on Actor\b/)
+    })
+
+    it('wraps mutations too', () => {
+        const doc = parse(`mutation m($w: Actor_bool_exp!) { update_Actor(where: $w) { affected_rows } }`)
+        const out = print(namespaceDocument(doc, 'genesisdev', PREFIXED))
+        assert.equal(
+            out,
+            normalize(`
+                mutation m($w: genesisdev_Actor_bool_exp!) {
+                    genesisdev { update_Actor(where: $w) { affected_rows } }
+                }
+            `),
+        )
+    })
+})
+
+describe('denamespaceData (transforms 4-5)', () => {
+    it('unwraps the namespace and strips __typename prefixes deeply', () => {
+        const wire = {
+            avansas: {
+                Actor: [
+                    {
+                        __typename: 'avansas_Actor',
+                        ActorNo: 1,
+                        ActorActor_Overordnet: [{ __typename: 'avansas_Actor', ActorNo: 2 }],
+                    },
+                ],
+            },
+        }
+        assert.deepEqual(denamespaceData(wire, 'avansas'), {
+            Actor: [
+                {
+                    __typename: 'Actor',
+                    ActorNo: 1,
+                    ActorActor_Overordnet: [{ __typename: 'Actor', ActorNo: 2 }],
+                },
+            ],
+        })
+    })
+
+    it('leaves unprefixed __typename values and non-typename fields untouched', () => {
+        const wire = { avansas: { Actor: [{ __typename: 'Actor', Navn: 'avansas_not_a_typename' }] } }
+        assert.deepEqual(denamespaceData(wire, 'avansas'), {
+            Actor: [{ __typename: 'Actor', Navn: 'avansas_not_a_typename' }],
+        })
+    })
+
+    it('passes data through when the namespace key is absent', () => {
+        assert.deepEqual(denamespaceData({ Actor: [] }, 'avansas'), { Actor: [] })
+    })
+})
+
+describe('adopusSlugFromJwt', () => {
+    const jwtWith = (claims: object) =>
+        `x.${Buffer.from(JSON.stringify(claims)).toString('base64url')}.y`
+
+    it('reads and sanitizes the subdomain claim', () => {
+        assert.equal(adopusSlugFromJwt(jwtWith({ subdomain: 'Fretex-Dev' })), 'fretex_dev')
+    })
+
+    it('returns undefined for missing token, missing claim, or unsanitizable subdomain', () => {
+        assert.equal(adopusSlugFromJwt(undefined), undefined)
+        assert.equal(adopusSlugFromJwt(jwtWith({})), undefined)
+        assert.equal(adopusSlugFromJwt(jwtWith({ subdomain: '1-bad!' })), undefined)
+    })
+})

package/src/helpers/adopusNamespaceExchange.ts

@@ -0,0 +1,215 @@
+/**
+ * adopusNamespaceExchange — urql exchange that maps unprefixed gql.tada operations onto the
+ * consolidated Adopus Hasura engine's per-tenant namespace, at the wire level only.
+ *
+ * Compile-time types stay the unprefixed avansas/AdOpusTest schema (DEC-004/DEC-011); this
+ * exchange rewrites the parsed document + JSON per request/response:
+ *   1. request:  wrap each operation's selection set in the `<slug>` root field
+ *   2. request:  prefix schema type names in variable definitions (`Actor_bool_exp` -> `<slug>_Actor_bool_exp`)
+ *   3. request:  prefix fragment type conditions (inline + named)
+ *   4. response: unwrap `data[<slug>]` -> `data`
+ *   5. response: strip the `<slug>_` prefix from `__typename` values
+ *
+ * `prefixedTypes` is the exact set of names the engine prefixes for the tenant source —
+ * generated at codegen time by adopus-hsr-wrapper/scripts/unwrap_client_schema.mjs
+ * (adopus-prefixed-types.json) so the runtime never guesses which names carry the prefix.
+ *
+ * Install it only on the SRV_AO_WRAPPER client and only when the resolved endpoint is the
+ * consolidated engine (`/api/hsr-wrapper/`) — the per-tenant `srv_urls.ao_wrapper` flip then
+ * switches endpoint and namespace mode atomically.
+ *
+ * @see asma-modules/_docs/adopus-graphql/plans/2026-07-11-00-14-plan-adopus-hasura2-consolidation.md:184 — §2.4.3 (DEC-004/DEC-015)
+ */
+import type { DocumentNode } from '@0no-co/graphql.web'
+import { makeOperation, type Exchange, type Operation, type OperationResult } from '@urql/core'
+import { map, pipe } from 'wonka'
+
+// Minimal structural AST model for exactly the nodes the transforms touch — graphql.web's
+// published types carry `kind: any`, which defeats discriminant narrowing; these mirror the
+// spec shape and the public API still speaks graphql.web's DocumentNode.
+interface NameNode {
+    kind: 'Name'
+    value: string
+}
+interface NamedTypeNode {
+    kind: 'NamedType'
+    name: NameNode
+}
+type AstTypeNode = NamedTypeNode | { kind: 'ListType' | 'NonNullType'; type: AstTypeNode }
+interface AstFieldNode {
+    kind: 'Field'
+    name: NameNode
+    selectionSet?: AstSelectionSetNode
+}
+interface AstInlineFragmentNode {
+    kind: 'InlineFragment'
+    typeCondition?: NamedTypeNode
+    selectionSet: AstSelectionSetNode
+}
+type AstSelectionNode = AstFieldNode | AstInlineFragmentNode | { kind: 'FragmentSpread'; name: NameNode }
+interface AstSelectionSetNode {
+    kind: 'SelectionSet'
+    selections: readonly AstSelectionNode[]
+}
+interface AstVariableDefinitionNode {
+    kind: 'VariableDefinition'
+    type: AstTypeNode
+}
+interface AstOperationDefinitionNode {
+    kind: 'OperationDefinition'
+    variableDefinitions?: readonly AstVariableDefinitionNode[]
+    selectionSet: AstSelectionSetNode
+}
+interface AstFragmentDefinitionNode {
+    kind: 'FragmentDefinition'
+    typeCondition: NamedTypeNode
+    selectionSet: AstSelectionSetNode
+}
+type AstDefinitionNode = AstOperationDefinitionNode | AstFragmentDefinitionNode | { kind: string }
+interface AstDocumentNode {
+    kind: 'Document'
+    definitions: readonly AstDefinitionNode[]
+}
+
+const SLUG_PATTERN = /^[a-z][a-z0-9_]{1,30}$/
+
+// not parseJwt.js — that module touches `window` at import time; this subpath stays environment-neutral
+function decodeJwtClaims(jwt: string): { subdomain?: string } | undefined {
+    const payload = jwt.split('.')[1]
+    if (!payload) return undefined
+    try {
+        const base64 = payload.replace(/-/g, '+').replace(/_/g, '/')
+        return JSON.parse(new TextDecoder().decode(Uint8Array.from(atob(base64), (c) => c.charCodeAt(0))))
+    } catch {
+        return undefined
+    }
+}
+
+/**
+ * Derive the tenant namespace slug from the main ASMA JWT's `subdomain` claim (DEC-015),
+ * sanitized per plan §1.1 (lowercase, hyphens -> underscores). Returns undefined when the
+ * token is missing or the claim does not sanitize to a valid slug — callers skip the
+ * exchange in that case.
+ */
+export function adopusSlugFromJwt(jwt: string | undefined): string | undefined {
+    if (!jwt) return undefined
+    const claims = decodeJwtClaims(jwt)
+    const slug = claims?.subdomain?.toLowerCase().replace(/-/g, '_')
+    if (!slug || !SLUG_PATTERN.test(slug)) {
+        console.error(`adopusSlugFromJwt: subdomain claim '${claims?.subdomain}' is not a valid namespace slug`)
+        return undefined
+    }
+    return slug
+}
+
+/** Transforms 1–3 on the parsed operation document. Pure; exported for tests. */
+export function namespaceDocument(document: DocumentNode, slug: string, prefixed: ReadonlySet<string>): DocumentNode {
+    const doc = document as unknown as AstDocumentNode
+
+    const prefixName = (name: NameNode): NameNode =>
+        prefixed.has(name.value) ? { ...name, value: `${slug}_${name.value}` } : name
+
+    const prefixType = (type: AstTypeNode): AstTypeNode =>
+        type.kind === 'NamedType' ? { ...type, name: prefixName(type.name) } : { ...type, type: prefixType(type.type) }
+
+    const prefixFragmentConditions = (selectionSet: AstSelectionSetNode): AstSelectionSetNode => ({
+        ...selectionSet,
+        selections: selectionSet.selections.map((sel): AstSelectionNode => {
+            if (sel.kind === 'InlineFragment') {
+                return {
+                    ...sel,
+                    typeCondition: sel.typeCondition && { ...sel.typeCondition, name: prefixName(sel.typeCondition.name) },
+                    selectionSet: prefixFragmentConditions(sel.selectionSet),
+                }
+            }
+            if (sel.kind === 'Field' && sel.selectionSet) {
+                return { ...sel, selectionSet: prefixFragmentConditions(sel.selectionSet) }
+            }
+            return sel
+        }),
+    })
+
+    const out: AstDocumentNode = {
+        ...doc,
+        definitions: doc.definitions.map((def): AstDefinitionNode => {
+            if (def.kind === 'OperationDefinition') {
+                const op = def as AstOperationDefinitionNode
+                const namespaceField: AstFieldNode = {
+                    kind: 'Field',
+                    name: { kind: 'Name', value: slug },
+                    selectionSet: prefixFragmentConditions(op.selectionSet),
+                }
+                return {
+                    ...op,
+                    variableDefinitions: op.variableDefinitions?.map((v) => ({ ...v, type: prefixType(v.type) })),
+                    selectionSet: { kind: 'SelectionSet', selections: [namespaceField] },
+                }
+            }
+            if (def.kind === 'FragmentDefinition') {
+                const frag = def as AstFragmentDefinitionNode
+                return {
+                    ...frag,
+                    typeCondition: { ...frag.typeCondition, name: prefixName(frag.typeCondition.name) },
+                    selectionSet: prefixFragmentConditions(frag.selectionSet),
+                }
+            }
+            return def
+        }),
+    }
+    return out as unknown as DocumentNode
+}
+
+/** Transforms 4–5 on the response payload. Pure (returns new objects); exported for tests. */
+export function denamespaceData<T>(data: T, slug: string): T {
+    const unwrapped =
+        data && typeof data === 'object' && !Array.isArray(data) && slug in (data as Record<string, unknown>)
+            ? (data as Record<string, unknown>)[slug]
+            : data
+    return stripTypenamePrefix(unwrapped, `${slug}_`) as T
+}
+
+function stripTypenamePrefix(value: unknown, prefix: string): unknown {
+    if (Array.isArray(value)) return value.map((v) => stripTypenamePrefix(v, prefix))
+    if (!value || typeof value !== 'object') return value
+    const out: Record<string, unknown> = {}
+    for (const [key, v] of Object.entries(value)) {
+        out[key] = key === '__typename' && typeof v === 'string' && v.startsWith(prefix) ? v.slice(prefix.length) : stripTypenamePrefix(v, prefix)
+    }
+    return out
+}
+
+/**
+ * @param slug tenant namespace — derive with `adopusSlugFromJwt(await getCachedJwt())`
+ * @param prefixedTypes contents of the codegen-emitted `adopus-prefixed-types.json`
+ */
+export function adopusNamespaceExchange({
+    slug,
+    prefixedTypes,
+}: {
+    slug: string
+    prefixedTypes: readonly string[]
+}): Exchange {
+    const prefixed: ReadonlySet<string> = new Set(prefixedTypes)
+    // documents are module-level gql.tada constants — stable references, so WeakMap memoizes
+    // the rewrite once per document (NOT per operation.key, which varies with variables)
+    const rewritten = new WeakMap<DocumentNode, DocumentNode>()
+
+    const rewriteOperation = (op: Operation): Operation => {
+        if (op.kind === 'teardown') return op
+        let query = rewritten.get(op.query)
+        if (!query) {
+            query = namespaceDocument(op.query, slug, prefixed)
+            rewritten.set(op.query, query)
+        }
+        return makeOperation(op.kind, { ...op, query }, op.context)
+    }
+
+    const rewriteResult = (result: OperationResult): OperationResult =>
+        result.operation.kind === 'teardown' || result.data == null
+            ? result // ponytail: error paths keep the <slug> segment — cosmetic, fix if it ever confuses anyone
+            : { ...result, data: denamespaceData(result.data, slug) }
+
+    return ({ forward }) =>
+        (ops$) =>
+            pipe(forward(pipe(ops$, map(rewriteOperation))), map(rewriteResult))
+}

package/src/helpers/generateSrvAuthBindings.ts

@@ -23,8 +23,8 @@ function dispatchJwtChangedEvent(jwt?: ICheckSigninOptions<any>) {
     dispatchSrvAuthEvents('jwt_changed', jwt, false)
 }
 /**
- * @generic FeatureEnums - feature_names_enums from asma-genql-directory
- * @generic SrvUrlsEnums - srv_names_enums from asma-genql-directory
+ * @generic FeatureEnums - feature_names_enums from directory introspection
+ * @generic SrvUrlsEnums - srv_names_enums from directory introspection
  */
 //type EnvConfigsFn = () => { SRV_AUTH: string; DEVELOPMENT: boolean; ENVIRONMENT_TO_OPERATE: string }
 

package/src/index.ts

@@ -18,7 +18,6 @@ export * from './helpers/generateSrvAuthBindings.types.js'
 export * from './helpers/getSubdomain.js'
 export * from './helpers/checkForRegisteredSubdomains.js'
 export * from './helpers/clearCacheData.js'
-export * from './helpers/generateGenqlClient.js'
 export * from './helpers/generateEnvConfigsBindings.js'
 export * from './helpers/userTypingSignal.js'
 export * from './helpers/base64ToFile.js'

package/lib/helpers/generateGenqlClient.d.ts

@@ -1,21 +0,0 @@
-import type { ClientOptions } from '@genql/runtime';
-import { type IEnvironmentUrlsGenQLOnly } from './generateEnvConfigsBindings.js';
-export interface CliOptions extends Omit<ClientOptions, 'url' | 'signal'> {
-    anonymous?: boolean;
-}
-export declare function generateGenqlClient<T extends ReturnType<typeof createClient>>({ setReqConfig, createClient, service, path, }: {
-    setReqConfig?: () => Promise<{
-        headers: Record<string, string>;
-    }>;
-    createClient: (options?: ClientOptions | undefined) => T;
-    service: keyof IEnvironmentUrlsGenQLOnly;
-    path?: string;
-}): {
-    getGenqlClient: () => Promise<T>;
-    resetGenqlClient: () => void;
-    genqlClient: (options?: CliOptions & {
-        abortController?: AbortController;
-    }) => Promise<T>;
-    genqlClientWs: () => Promise<T>;
-};
-//# sourceMappingURL=generateGenqlClient.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"generateGenqlClient.d.ts","sourceRoot":"","sources":["../../src/helpers/generateGenqlClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,EAEH,KAAK,yBAAyB,EAGjC,MAAM,iCAAiC,CAAA;AAIxC,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,QAAQ,CAAC;IACrE,SAAS,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,YAAY,CAAC,EAAE,EAC3E,YAAY,EACZ,YAAY,EACZ,OAAO,EAEP,IAAoB,GACvB,EAAE;IACC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAA;IACjE,YAAY,EAAE,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,KAAK,CAAC,CAAA;IAExD,OAAO,EAAE,MAAM,yBAAyB,CAAA;IACxC,IAAI,CAAC,EAAE,MAAM,CAAA;CAChB;;;4BA+DuC,UAAU,GAAG;QAAE,eAAe,CAAC,EAAE,eAAe,CAAA;KAAE,KAAQ,OAAO,CAAC,CAAC,CAAC;;EAqD3G"}

package/lib/helpers/generateGenqlClient.js

@@ -1,98 +0,0 @@
-import { httpToWs } from './Config.js';
-import { EnvConfigsFnInternal,
-//IKeyEnvironmentUrls,
-//IKeyEnvironmentUrlsOmit,
- } from './generateEnvConfigsBindings.js';
-import { getSrvUrlsInternal, registerCallbackOnSrvAuthEvents, setReqConfigInternal } from './generateSrvAuthBindings.js';
-export function generateGenqlClient({ setReqConfig, createClient, service, 
-//serviceUrl,
-path = '/v1/graphql', }) {
-    let client = null;
-    let wsClient = null;
-    let local_abortController_registry = [];
-    registerCallbackOnSrvAuthEvents('logout_event', () => {
-        local_abortController_registry.forEach((ac) => ac.abort());
-        resetClients();
-    });
-    function resetClients() {
-        client = null;
-        wsClient = null;
-        local_abortController_registry = [];
-    }
-    //registerCallbackOnSrvAuthEvents('logout_event', resetClients)
-    async function getGenqlClient() {
-        if (client === null) {
-            client = await genqlClient();
-            return client;
-        }
-        return client;
-    }
-    function resetGenqlClient() {
-        client = null;
-        wsClient = null;
-    }
-    function serviceUrlFn() {
-        let service_url = EnvConfigsFnInternal()[service];
-        if ('SRV_AO_WRAPPER' === service) {
-            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) {
-            const message = `'required param serviceUrl() is undefined, please check EnvConfig object!', service: ${service}`;
-            throw Error(message);
-        }
-        console.log('asma-helpers - generateGenqlClient service_url', service_url);
-        return service_url;
-    }
-    const reqConf = setReqConfig || setReqConfigInternal;
-    async function genqlClient(options = {}) {
-        const { headers, abortController: abortControllerFromOpts, ...rest } = options;
-        /*  if (!serviceUrl()) {
-            throw Error('required param srv_url is undefined, please check EnvConfig object!')
-        } */
-        const abortControllerLocal = createAbortControllerAndAbortOnLogoutEvent(abortControllerFromOpts);
-        const serviceUrlWithPath = serviceUrlFn() + path;
-        return createClient({
-            url: serviceUrlWithPath,
-            headers: async () => ({
-                ...(options.anonymous ? {} : ((await reqConf()).headers ?? {})),
-                ...headers,
-            }),
-            signal: abortControllerLocal.signal,
-            batch: { batchInterval: 50, maxBatchSize: 100 },
-            ...rest,
-        });
-    }
-    async function genqlClientWs() {
-        if (!wsClient) {
-            const aborControllerLocal = createAbortControllerAndAbortOnLogoutEvent();
-            wsClient = createClient({
-                url: `${httpToWs(serviceUrlFn())}${path}`,
-                cache: 'reload',
-                batch: { batchInterval: 50, maxBatchSize: 100 },
-                signal: aborControllerLocal.signal,
-                subscription: {
-                    reconnect: true,
-                    reconnectionAttempts: 5,
-                    headers: async () => ((await reqConf()).headers ?? {}),
-                },
-            });
-        }
-        return wsClient;
-    }
-    function createAbortControllerAndAbortOnLogoutEvent(abortControllerFromFnSig) {
-        const localAbrotController = abortControllerFromFnSig || new AbortController();
-        local_abortController_registry.push(localAbrotController);
-        return localAbrotController;
-    }
-    return { getGenqlClient, resetGenqlClient, genqlClient, genqlClientWs };
-}
-//# sourceMappingURL=generateGenqlClient.js.map

package/lib/helpers/generateGenqlClient.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"generateGenqlClient.js","sourceRoot":"","sources":["../../src/helpers/generateGenqlClient.ts"],"names":[],"mappings":"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"}

package/src/helpers/generateGenqlClient.ts

@@ -1,145 +0,0 @@
-import type { createClient } from '@genql/runtime'
-import type { ClientOptions } from '@genql/runtime'
-import { httpToWs } from './Config.js'
-import {
-    EnvConfigsFnInternal,
-    type IEnvironmentUrlsGenQLOnly,
-    //IKeyEnvironmentUrls,
-    //IKeyEnvironmentUrlsOmit,
-} from './generateEnvConfigsBindings.js'
-import { getSrvUrlsInternal, registerCallbackOnSrvAuthEvents, setReqConfigInternal } from './generateSrvAuthBindings.js'
-//import { parseJwt } from '../helpers/parseJwt'
-
-export interface CliOptions extends Omit<ClientOptions, 'url' | 'signal'> {
-    anonymous?: boolean
-}
-
-export function generateGenqlClient<T extends ReturnType<typeof createClient>>({
-    setReqConfig,
-    createClient,
-    service,
-    //serviceUrl,
-    path = '/v1/graphql',
-}: {
-    setReqConfig?: () => Promise<{ headers: Record<string, string> }>
-    createClient: (options?: ClientOptions | undefined) => T
-    //serviceUrl?: () => string
-    service: keyof IEnvironmentUrlsGenQLOnly
-    path?: string
-}) {
-    let client: T | null = null
-
-    let wsClient: T | null = null
-
-    let local_abortController_registry: AbortController[] = []
-
-    registerCallbackOnSrvAuthEvents('logout_event', () => {
-        local_abortController_registry.forEach((ac) => ac.abort())
-
-        resetClients()
-    })
-
-    function resetClients() {
-        client = null
-
-        wsClient = null
-
-        local_abortController_registry = []
-    }
-
-    //registerCallbackOnSrvAuthEvents('logout_event', resetClients)
-
-    async function getGenqlClient() {
-        if (client === null) {
-            client = await genqlClient()
-
-            return client
-        }
-
-        return client
-    }
-
-    function resetGenqlClient() {
-        client = null
-
-        wsClient = null
-    }
-    function serviceUrlFn() {
-        let service_url = EnvConfigsFnInternal()[service]
-
-        if ('SRV_AO_WRAPPER' === service) {
-            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) {
-            const message = `'required param serviceUrl() is undefined, please check EnvConfig object!', service: ${service}`
-            throw Error(message)
-        }
-        console.log('asma-helpers - generateGenqlClient service_url', service_url)
-        return service_url
-    }
-    const reqConf = setReqConfig || setReqConfigInternal
-
-    async function genqlClient(options: CliOptions & { abortController?: AbortController } = {}): Promise<T> {
-        const { headers, abortController: abortControllerFromOpts, ...rest } = options
-
-        /*  if (!serviceUrl()) {
-            throw Error('required param srv_url is undefined, please check EnvConfig object!')
-        } */
-
-        const abortControllerLocal = createAbortControllerAndAbortOnLogoutEvent(abortControllerFromOpts)
-
-        const serviceUrlWithPath = serviceUrlFn() + path
-
-        return createClient({
-            url: serviceUrlWithPath,
-            headers: async () => ({
-                ...(options.anonymous ? {} : (((await reqConf()).headers ?? {}) as Record<string, string>)),
-                ...headers,
-            }),
-
-            signal: abortControllerLocal.signal,
-            batch: { batchInterval: 50, maxBatchSize: 100 },
-            ...rest,
-        })
-    }
-
-    async function genqlClientWs() {
-        if (!wsClient) {
-            const aborControllerLocal = createAbortControllerAndAbortOnLogoutEvent()
-
-            wsClient = createClient({
-                url: `${httpToWs(serviceUrlFn())}${path}`,
-                cache: 'reload',
-                batch: { batchInterval: 50, maxBatchSize: 100 },
-                signal: aborControllerLocal.signal,
-                subscription: {
-                    reconnect: true,
-                    reconnectionAttempts: 5,
-                    headers: async () => ((await reqConf()).headers ?? {}) as Record<string, string>,
-                },
-            })
-        }
-
-        return wsClient
-    }
-
-    function createAbortControllerAndAbortOnLogoutEvent(abortControllerFromFnSig?: AbortController) {
-        const localAbrotController = abortControllerFromFnSig || new AbortController()
-
-        local_abortController_registry.push(localAbrotController)
-
-        return localAbrotController
-    }
-
-    return { getGenqlClient, resetGenqlClient, genqlClient, genqlClientWs }
-}