poc: runtime resource override resolution for getByName

src/services/folder-scoped.ts

@@ -7,6 +7,7 @@ import { addPrefixToKeys, transformOptions, FieldMapping } from '../utils/transf
 import { NotFoundError } from '../core/errors';
 import { validateName } from '../utils/validation/name-validator';
 import { resolveFolderHeaders } from '../utils/folder/folder-headers';
+import { resolveOverride, type ResourceOverride } from '../utils/overrides/resolve-override';
 
 /**
  * Matches single-quote characters in OData string literals — escaped to `''`
@@ -96,10 +97,21 @@ export class FolderScopedService extends BaseService {
     const validatedName = validateName(resourceType, name);
     const { folderId, folderKey, folderPath, ...queryOptions } = options;
 
+    // The compiled code passes the DEFAULT name (e.g. "CustomerConfig").
+    // At runtime, check if an admin override exists for this resource.
+    // If so, use the overridden name and folderPath for the API call.
+    const override: ResourceOverride | null = resolveOverride(
+      resourceType.toLowerCase(),
+      validatedName,
+      folderPath ?? '.'
+    );
+    const resolvedName = override?.name ?? validatedName;
+    const resolvedFolderPath = override?.folderPath ?? folderPath;
+
     const headers = resolveFolderHeaders({
       folderId,
       folderKey,
-      folderPath,
+      folderPath: resolvedFolderPath,
       resourceType: `${resourceType}.getByName`,
       fallbackFolderKey: this.config.folderKey,
     });
@@ -110,7 +122,7 @@ export class FolderScopedService extends BaseService {
 
     const apiOptions = {
       ...addPrefixToKeys(apiFieldOptions, ODATA_PREFIX, Object.keys(apiFieldOptions)),
-      '$filter': `Name eq '${validatedName.replace(SINGLE_QUOTE_RE, "''")}'`,
+      '$filter': `Name eq '${resolvedName.replace(SINGLE_QUOTE_RE, "''")}'`,
       '$top': '1',
     };
 
@@ -121,9 +133,9 @@ export class FolderScopedService extends BaseService {
 
     const items = response.data?.value;
     if (!items?.length) {
-      const folderHint = describeFolderForError(folderId, folderKey, folderPath);
+      const folderHint = describeFolderForError(folderId, folderKey, resolvedFolderPath);
       throw new NotFoundError({
-        message: `${resourceType} '${validatedName}' not found${folderHint}.`,
+        message: `${resourceType} '${resolvedName}' not found${folderHint}.`,
       });
     }
 

src/utils/overrides/resolve-override.ts

@@ -0,0 +1,66 @@
+/**
+ * Runtime resource override resolution.
+ *
+ * Reads the override dict from <script type="application/json" id="uipath-overrides">
+ * injected into index.html at deploy time (by syncResourceOverwritesToCdn).
+ *
+ * The override dict maps binding keys to new resource names/folders:
+ *   { "asset.CustomerConfig.Shared/PublicApps": { "name": "ProdConfig", "folderPath": "Production/Live" } }
+ *
+ * The DEFAULT name from bindings.gen.ts (compiled into the bundle) acts as
+ * a LOOKUP KEY. This function resolves it to the overridden value at runtime.
+ */
+
+export interface ResourceOverride {
+  name: string;
+  folderPath: string;
+}
+
+type OverrideDict = Record<string, ResourceOverride>;
+
+let cachedOverrides: OverrideDict | null = null;
+let loaded = false;
+
+function loadOverrides(): OverrideDict {
+  if (loaded) return cachedOverrides ?? {};
+
+  loaded = true;
+
+  if (typeof document === 'undefined') return {};
+
+  const el = document.getElementById('uipath-overrides');
+  if (!el) return {};
+
+  try {
+    cachedOverrides = JSON.parse(el.textContent ?? '{}');
+    console.log('[UiPath SDK] Loaded overrides:', cachedOverrides);
+    return cachedOverrides ?? {};
+  } catch {
+    console.warn('[UiPath SDK] Failed to parse uipath-overrides script tag');
+    return {};
+  }
+}
+
+/**
+ * Resolves a resource override at runtime.
+ *
+ * @param resourceType - e.g. "asset", "entity", "bucket"
+ * @param name - the DEFAULT resource name from compiled bindings (e.g. "CustomerConfig")
+ * @param folderPath - the DEFAULT folder path (e.g. "Shared/PublicApps")
+ * @returns the override if found, or null if no override exists
+ */
+export function resolveOverride(
+  resourceType: string,
+  name: string,
+  folderPath: string,
+): ResourceOverride | null {
+  const overrides = loadOverrides();
+  const key = `${resourceType}.${name}.${folderPath}`;
+  const override = overrides[key] ?? null;
+
+  if (override) {
+    console.log(`[UiPath SDK] Override resolved: "${name}" → "${override.name}" (folder: "${override.folderPath}")`);
+  }
+
+  return override;
+}