From 1ac51bc7d31cb22b70f161b7f2ac7ff20f37b3b3 Mon Sep 17 00:00:00 2001
From: Raina451 <raina.middha@uipath.com>
Date: Thu, 2 Jul 2026 15:57:18 +0530
Subject: [PATCH 1/2] poc: add runtime resource override resolution for
 getByName
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds override resolution to FolderScopedService.getByNameLookup so that
admin-time resource overrides (injected into index.html as
<script id="uipath-overrides">) are applied at runtime before making
API calls.

When a developer calls assets.getByName("CustomerConfig"), the compiled
bundle has "CustomerConfig" hardcoded. At runtime, the SDK now reads the
override dict from the DOM. If an admin overrode "CustomerConfig" to
"ProdConfig", the $filter sent to the API uses "ProdConfig" instead.

This is a POC — production implementation needs:
- Cache invalidation when overrides change
- Support for entity/bucket services (not just folder-scoped)
- Integration with the overrides team's delivery mechanism
- Unit tests

Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
---
 src/services/folder-scoped.ts           | 21 ++++++--
 src/utils/overrides/resolve-override.ts | 66 +++++++++++++++++++++++++
 2 files changed, 83 insertions(+), 4 deletions(-)
 create mode 100644 src/utils/overrides/resolve-override.ts

diff --git a/src/services/folder-scoped.ts b/src/services/folder-scoped.ts
index 38816c491..e4abfb74f 100644
--- a/src/services/folder-scoped.ts
+++ b/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,22 @@ export class FolderScopedService extends BaseService {
     const validatedName = validateName(resourceType, name);
     const { folderId, folderKey, folderPath, ...queryOptions } = options;
 
+    // --- Override resolution (POC) ---
+    // 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 +123,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 +134,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}.`,
       });
     }
 
diff --git a/src/utils/overrides/resolve-override.ts b/src/utils/overrides/resolve-override.ts
new file mode 100644
index 000000000..d2e41f790
--- /dev/null
+++ b/src/utils/overrides/resolve-override.ts
@@ -0,0 +1,66 @@
+/**
+ * POC: 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;
+}

From 9cd12fb2447d164f657cbbac66407423b6b6e2f2 Mon Sep 17 00:00:00 2001
From: Raina451 <raina.middha@uipath.com>
Date: Thu, 2 Jul 2026 15:58:51 +0530
Subject: [PATCH 2/2] chore: remove POC references from override resolution
 code

Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
---
 src/services/folder-scoped.ts           | 1 -
 src/utils/overrides/resolve-override.ts | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/services/folder-scoped.ts b/src/services/folder-scoped.ts
index e4abfb74f..642c87460 100644
--- a/src/services/folder-scoped.ts
+++ b/src/services/folder-scoped.ts
@@ -97,7 +97,6 @@ export class FolderScopedService extends BaseService {
     const validatedName = validateName(resourceType, name);
     const { folderId, folderKey, folderPath, ...queryOptions } = options;
 
-    // --- Override resolution (POC) ---
     // 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.
diff --git a/src/utils/overrides/resolve-override.ts b/src/utils/overrides/resolve-override.ts
index d2e41f790..7a464e93f 100644
--- a/src/utils/overrides/resolve-override.ts
+++ b/src/utils/overrides/resolve-override.ts
@@ -1,5 +1,5 @@
 /**
- * POC: Runtime resource override resolution.
+ * 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).