@salesforce/angular-plugin-ui-bundle 10.23.0

package/LICENSE.txt

@@ -0,0 +1,82 @@
+Terms of Use
+
+Copyright 2026 Salesforce, Inc. All rights reserved.
+
+These Terms of Use govern the download, installation, and/or use of this
+software provided by Salesforce, Inc. ("Salesforce") (the "Software"), were
+last updated on April 15, 2025, and constitute a legally binding
+agreement between you and Salesforce. If you do not agree to these Terms of
+Use, do not install or use the Software.
+
+Salesforce grants you a worldwide, non-exclusive, no-charge, royalty-free
+copyright license to reproduce, prepare derivative works of, publicly
+display, publicly perform, sublicense, and distribute the Software and
+derivative works subject to these Terms. These Terms shall be included in
+all copies or substantial portions of the Software.
+
+Subject to the limited rights expressly granted hereunder, Salesforce
+reserves all rights, title, and interest in and to all intellectual
+property subsisting in the Software. No rights are granted to you hereunder
+other than as expressly set forth herein. Users residing in countries on
+the United States Office of Foreign Assets Control sanction list, or which
+are otherwise subject to a US export embargo, may not use the Software.
+
+Implementation of the Software may require development work, for which you
+are responsible. The Software may contain bugs, errors and
+incompatibilities and is made available on an AS IS basis without support,
+updates, or service level commitments.
+
+Salesforce reserves the right at any time to modify, suspend, or
+discontinue, the Software (or any part thereof) with or without notice. You
+agree that Salesforce shall not be liable to you or to any third party for
+any modification, suspension, or discontinuance.
+
+You agree to defend Salesforce against any claim, demand, suit or
+proceeding made or brought against Salesforce by a third party arising out
+of or accruing from (a) your use of the Software, and (b) any application
+you develop with the Software that infringes any copyright, trademark,
+trade secret, trade dress, patent, or other intellectual property right of
+any person or defames any person or violates their rights of publicity or
+privacy (each a "Claim Against Salesforce"), and will indemnify Salesforce
+from any damages, attorney fees, and costs finally awarded against
+Salesforce as a result of, or for any amounts paid by Salesforce under a
+settlement approved by you in writing of, a Claim Against Salesforce,
+provided Salesforce (x) promptly gives you written notice of the Claim
+Against Salesforce, (y) gives you sole control of the defense and
+settlement of the Claim Against Salesforce (except that you may not settle
+any Claim Against Salesforce unless it unconditionally releases Salesforce
+of all liability), and (z) gives you all reasonable assistance, at your
+expense.
+
+WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, THE SOFTWARE IS NOT
+SUPPORTED AND IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED. IN NO EVENT SHALL SALESFORCE HAVE ANY LIABILITY FOR ANY DAMAGES,
+INCLUDING, BUT NOT LIMITED TO, DIRECT, INDIRECT, SPECIAL, INCIDENTAL,
+PUNITIVE, OR CONSEQUENTIAL DAMAGES, OR DAMAGES BASED ON LOST PROFITS, DATA,
+OR USE, IN CONNECTION WITH THE SOFTWARE, HOWEVER CAUSED AND WHETHER IN
+CONTRACT, TORT, OR UNDER ANY OTHER THEORY OF LIABILITY, WHETHER OR NOT YOU
+HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+These Terms of Use shall be governed exclusively by the internal laws of
+the State of California, without regard to its conflicts of laws
+rules. Each party hereby consents to the exclusive jurisdiction of the
+state and federal courts located in San Francisco County, California to
+adjudicate any dispute arising out of or relating to these Terms of Use and
+the download, installation, and/or use of the Software. Except as expressly
+stated herein, these Terms of Use constitute the entire agreement between
+the parties, and supersede all prior and contemporaneous agreements,
+proposals, or representations, written or oral, concerning their subject
+matter. No modification, amendment, or waiver of any provision of these
+Terms of Use shall be effective unless it is by an update to these Terms of
+Use that Salesforce makes available, or is in writing and signed by the
+party against whom the modification, amendment, or waiver is to be
+asserted.
+
+Data Privacy: Salesforce may collect, process, and store device,
+system, and other information related to your use of the Software. This
+information includes, but is not limited to, IP address, user metrics, and
+other data ("Usage Data"). Salesforce may use Usage Data for analytics,
+product development, and marketing purposes. You acknowledge that files
+generated in conjunction with the Software may contain sensitive or
+confidential data, and you are solely responsible for anonymizing and
+protecting such data.

package/README.md

@@ -0,0 +1,3 @@
+# @salesforce/angular-plugin-ui-bundle
+
+Angular CLI plugin for Salesforce UI Bundles

package/dist/api-version.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Resolve the Salesforce org API version from the connected sf CLI session.
+ * Falls back to DEFAULT_API_VERSION when no org is connected or on error.
+ */
+export declare function resolveApiVersion(orgAlias?: string): Promise<string>;
+//# sourceMappingURL=api-version.d.ts.map

package/dist/api-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-version.d.ts","sourceRoot":"","sources":["../src/api-version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO1E"}

package/dist/api-version.js

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { getOrgInfo } from "@salesforce/ui-bundle/app";
+import { DEFAULT_API_VERSION } from "./utils.js";
+/**
+ * Resolve the Salesforce org API version from the connected sf CLI session.
+ * Falls back to DEFAULT_API_VERSION when no org is connected or on error.
+ */
+export async function resolveApiVersion(orgAlias) {
+    try {
+        const orgInfo = await getOrgInfo(orgAlias);
+        return orgInfo?.apiVersion || DEFAULT_API_VERSION;
+    }
+    catch {
+        return DEFAULT_API_VERSION;
+    }
+}

package/dist/bin/serve.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env -S node --no-deprecation
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export {};
+//# sourceMappingURL=serve.d.ts.map

package/dist/bin/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/bin/serve.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/bin/serve.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env -S node --no-deprecation
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * sf-angular-serve — dev server wrapper for Angular CLI UI Bundles.
+ *
+ * Resolves API version from sf CLI session, then spawns ng serve with:
+ *   --define: substitutes __SF_API_VERSION__ in Vite's optimizeDeps prebundle
+ *   --port: pins to SF_UIBUNDLE_PORT (default 5173) for orchestrator discovery
+ *
+ * Why this exists: Angular CLI's esbuild plugin (angular.json plugins[]) only
+ * reaches the app build pass. Vite's optimizeDeps prebundle is a separate
+ * esbuild invocation — --define is the only way to reach it.
+ */
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { createApiVersionPlugin } from "../plugins/api-version.js";
+import { getPort } from "../utils.js";
+const { version } = await createApiVersionPlugin();
+const port = getPort();
+// esbuild --define needs valid JS source for the value ("68.0", not 68.0), so
+// JSON.stringify once. No shell here (spawn without shell:true), so there is no
+// shell to strip a quoting layer — a second stringify would bake literal quotes
+// into the value and produce /services/data/v"68.0"/.
+const defineArg = `__SF_API_VERSION__=${JSON.stringify(version)}`;
+// Resolve Angular CLI bin without shell: spawn ng.js with the current Node executable.
+// This works cross-platform (Windows included) without shell: true.
+//
+// Resolve from the consuming app first (process.cwd() = where sf-angular-serve was
+// invoked). This is required in local dev where the plugin is symlinked via `file:`:
+// import.meta.url then points outside the app, so a module-relative resolve would miss
+// the app's @angular/cli. Fall back to module-relative for hoisted published installs.
+function resolveNgCli() {
+    try {
+        const requireFromApp = createRequire(pathToFileURL(join(process.cwd(), "package.json")));
+        return requireFromApp.resolve("@angular/cli/bin/ng.js");
+    }
+    catch {
+        return createRequire(import.meta.url).resolve("@angular/cli/bin/ng.js");
+    }
+}
+let ngPath;
+try {
+    ngPath = resolveNgCli();
+}
+catch {
+    console.error("[sf-angular-serve] Error: @angular/cli is not installed.\n" +
+        "Please install it in your project: npm install --save-dev @angular/cli");
+    process.exit(1);
+}
+const child = spawn(process.execPath, [ngPath, "serve", `--define=${defineArg}`, `--port=${port}`], {
+    stdio: "inherit",
+    env: { ...process.env, NODE_OPTIONS: "--no-deprecation" },
+});
+child.on("error", (err) => {
+    console.error("[sf-angular-serve] Failed to start ng:", err.message);
+    process.exit(1);
+});
+child.on("exit", (code) => {
+    process.exit(code ?? 0);
+});
+process.on("SIGINT", () => {
+    child.kill("SIGINT");
+});
+process.on("SIGTERM", () => {
+    child.kill("SIGTERM");
+});

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export type { SalesforceOptions, Middleware } from "./types.ts";
+export type { ApiVersionResult } from "./plugins/api-version.ts";
+export { createApiVersionPlugin } from "./plugins/api-version.ts";
+export { DEFAULT_API_VERSION, DEFAULT_PORT, getPort } from "./utils.ts";
+export { createProxyMiddleware } from "./middleware/proxy.ts";
+export { createHtmlMiddleware } from "./middleware/html.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export { createApiVersionPlugin } from "./plugins/api-version.js";
+export { DEFAULT_API_VERSION, DEFAULT_PORT, getPort } from "./utils.js";
+export { createProxyMiddleware } from "./middleware/proxy.js";
+export { createHtmlMiddleware } from "./middleware/html.js";

package/dist/middleware/html.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { Middleware, SalesforceOptions } from "../types.ts";
+export declare function createHtmlMiddleware(options?: SalesforceOptions): Promise<Middleware>;
+//# sourceMappingURL=html.d.ts.map

package/dist/middleware/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/middleware/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA8DjE,wBAAsB,oBAAoB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CA+E/F"}

package/dist/middleware/html.js

@@ -0,0 +1,141 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * HTML injection middleware for ng serve.
+ * Intercepts HTML navigation responses (SPA routes) and injects the Live
+ * Preview script, SFDC_ENV global, and base href. Skips static files and
+ * /services/ paths.
+ *
+ * Execution order: BEFORE proxy middleware (wrapping must happen first).
+ *
+ * The transform is split into two parts within this file: createIndexHtmlTransformer
+ * is a pure string-in/string-out function (easy to unit-test on its own), and
+ * createHtmlMiddleware is the res/req plumbing that buffers the response and feeds
+ * it through that transform. The transformer is intentionally not part of the
+ * package's public API — it is only ever consumed by this middleware.
+ */
+import { getOrgInfo } from "@salesforce/ui-bundle/app";
+import { injectLivePreviewScript } from "@salesforce/ui-bundle/proxy";
+import { getCodeBuilderBasePath, getPort } from "../utils.js";
+/**
+ * Factory: creates an HTML transform function bound to the current environment.
+ * Resolves basePath once (from CODE_BUILDER_FRAMEWORK_PROXY_URI or "/") and
+ * returns a pure transform. Only invoked by the ng serve middleware, so it
+ * always injects — there is no build-time caller to guard against.
+ */
+async function createIndexHtmlTransformer(options = {}) {
+    const port = getPort();
+    const codeBuilderProxyUrl = process.env.CODE_BUILDER_FRAMEWORK_PROXY_URI;
+    const isCodeBuilder = !!codeBuilderProxyUrl;
+    const basePath = isCodeBuilder ? getCodeBuilderBasePath(codeBuilderProxyUrl, port) : "/";
+    const apiPath = basePath;
+    // Resolve org URL for SFDC_ENV (used by Lightning Out, etc.)
+    let orgUrl;
+    try {
+        const orgInfo = await getOrgInfo(options.orgAlias);
+        orgUrl = orgInfo?.instanceUrl;
+    }
+    catch {
+        orgUrl = undefined;
+    }
+    if (options.debug) {
+        console.log(`[angular-plugin-ui-bundle] HTML transformer: basePath="${basePath}", isCodeBuilder=${isCodeBuilder}, port=${port}, orgUrl=${orgUrl}`);
+    }
+    return (html) => {
+        // 1. Live Preview script (enables VS Code extension communication)
+        html = injectLivePreviewScript(html);
+        // 2. Inject <base href> with computed basePath (Code Builder or "/")
+        //    If a base tag exists, replace it; otherwise inject after <head> (or skip if no <head>)
+        const baseHref = basePath.endsWith("/") ? basePath : `${basePath}/`;
+        // Match any <base ...> tag (single/double quotes, attributes in any order).
+        const baseTagRegex = /<base\b[^>]*>/i;
+        if (baseTagRegex.test(html)) {
+            html = html.replace(baseTagRegex, `<base href="${baseHref}">`);
+        }
+        else if (/<head(\s[^>]*)?>/i.test(html)) {
+            html = html.replace(/<head(\s[^>]*)?>/i, (match) => `${match}\n  <base href="${baseHref}">`);
+        }
+        // 3. SFDC_ENV global (basePath + apiPath + orgUrl)
+        const orgUrlEntry = orgUrl ? `, orgUrl: "${orgUrl}"` : "";
+        const sfdcEnvScript = `<script>(function() { globalThis.SFDC_ENV = { basePath: "${basePath}", apiPath: "${apiPath}"${orgUrlEntry} }; })();</script>`;
+        if (html.includes("</head>")) {
+            html = html.replace("</head>", `  ${sfdcEnvScript}\n</head>`);
+        }
+        return html;
+    };
+}
+export async function createHtmlMiddleware(options = {}) {
+    const htmlTransformer = await createIndexHtmlTransformer(options);
+    return (req, res, next) => {
+        // Skip static files (.js, .css, .ico) and internal paths
+        const url = req.url?.split("?")[0] ?? "/";
+        const hasExtension = url.lastIndexOf(".") > url.lastIndexOf("/");
+        const isServicePath = url.startsWith("/services/") || url.startsWith("/@");
+        if (hasExtension || isServicePath) {
+            if (next)
+                next();
+            return;
+        }
+        // Wrap response to intercept HTML from Angular's Vite dev server
+        const originalEnd = res.end.bind(res);
+        let body = Buffer.from("");
+        res.write = function (chunk) {
+            body = Buffer.concat([body, Buffer.from(chunk)]);
+            return true;
+        };
+        res.end = function (chunk) {
+            if (chunk) {
+                body = Buffer.concat([body, Buffer.from(chunk)]);
+            }
+            // Skip transformation if content-type header is present and not text/html
+            const contentType = res.getHeader("content-type");
+            if (contentType !== undefined) {
+                const contentTypeStr = Array.isArray(contentType)
+                    ? (contentType[0] ?? "")
+                    : String(contentType);
+                if (!contentTypeStr.includes("text/html")) {
+                    originalEnd(body);
+                    return res;
+                }
+            }
+            const html = body.toString("utf8");
+            try {
+                const transformedResult = htmlTransformer(html);
+                Promise.resolve(transformedResult)
+                    .then((finalHtml) => {
+                    if (options.debug) {
+                        console.log("[angular-plugin-ui-bundle] HTML transformed for dev mode");
+                    }
+                    const finalBuffer = Buffer.from(finalHtml, "utf8");
+                    if (!res.headersSent) {
+                        res.setHeader("content-length", finalBuffer.byteLength);
+                    }
+                    originalEnd(finalBuffer);
+                })
+                    .catch((error) => {
+                    console.error("[angular-plugin-ui-bundle] HTML transformation failed:", error);
+                    const fallbackBuffer = Buffer.from(html, "utf8");
+                    if (!res.headersSent) {
+                        res.setHeader("content-length", fallbackBuffer.byteLength);
+                    }
+                    originalEnd(fallbackBuffer);
+                });
+            }
+            catch (error) {
+                console.error("[angular-plugin-ui-bundle] HTML transformation failed:", error);
+                const fallbackBuffer = Buffer.from(html, "utf8");
+                if (!res.headersSent) {
+                    res.setHeader("content-length", fallbackBuffer.byteLength);
+                }
+                originalEnd(fallbackBuffer);
+            }
+            return res;
+        };
+        // Let Angular serve the HTML — we intercept via wrapped res.end
+        if (next)
+            next();
+    };
+}

package/dist/middleware/proxy.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { Middleware, SalesforceOptions } from "../types.ts";
+export declare function createProxyMiddleware(options?: SalesforceOptions): Promise<Middleware>;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/middleware/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/middleware/proxy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAuBjE,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAkEhG"}

package/dist/middleware/proxy.js

@@ -0,0 +1,96 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Proxy middleware factory.
+ * Forwards /services/* requests to the connected Salesforce org with auth.
+ * Watches ui-bundle.json for route changes and rebuilds handler automatically.
+ *
+ * Execution order: AFTER HTML middleware.
+ */
+import { resolve } from "node:path";
+import { loadManifest, getOrgInfo } from "@salesforce/ui-bundle/app";
+import { createProxyHandler } from "@salesforce/ui-bundle/proxy";
+import { watch } from "chokidar";
+import { getCodeBuilderBasePath, getPort } from "../utils.js";
+function buildHandler(manifest, orgInfo, options) {
+    const port = getPort();
+    const codeBuilderProxyUrl = process.env.CODE_BUILDER_FRAMEWORK_PROXY_URI;
+    const target = codeBuilderProxyUrl
+        ? getCodeBuilderBasePath(codeBuilderProxyUrl, port)
+        : `http://localhost:${port}`;
+    // basePath must be undefined for local dev (not "/") to avoid double-slash in routes
+    const basePath = codeBuilderProxyUrl
+        ? getCodeBuilderBasePath(codeBuilderProxyUrl, port)
+        : undefined;
+    return createProxyHandler(manifest, orgInfo, target, basePath, {
+        debug: options.debug ?? false,
+    });
+}
+export async function createProxyMiddleware(options = {}) {
+    // Function-local state — captured by closures below
+    let cachedManifest;
+    let cachedOrgInfo;
+    let currentHandler;
+    const manifestPath = resolve(process.cwd(), "ui-bundle.json");
+    if (!cachedManifest) {
+        cachedManifest = await loadManifest(manifestPath);
+    }
+    if (!cachedOrgInfo) {
+        try {
+            cachedOrgInfo = await getOrgInfo(options.orgAlias);
+        }
+        catch {
+            cachedOrgInfo = undefined;
+        }
+    }
+    if (cachedManifest) {
+        currentHandler = buildHandler(cachedManifest, cachedOrgInfo, options);
+    }
+    // Watch manifest — rebuild handler on change (no browser reload, manual refresh needed)
+    const watcher = watch(manifestPath, { ignoreInitial: true });
+    watcher.on("change", async () => {
+        try {
+            const updated = await loadManifest(manifestPath);
+            if (updated) {
+                cachedManifest = updated;
+                currentHandler = buildHandler(cachedManifest, cachedOrgInfo, options);
+            }
+        }
+        catch (error) {
+            console.error("[angular-plugin-ui-bundle] Failed to reload ui-bundle.json:", error);
+        }
+    });
+    const middleware = async (req, res, next) => {
+        // Health check for sf ui-bundle dev orchestrator
+        if (req.url?.includes("sfProxyHealthCheck=true")) {
+            res.setHeader("X-Salesforce-UIBundle-Proxy", "true");
+            res.writeHead(200);
+            res.end();
+            return;
+        }
+        if (currentHandler) {
+            try {
+                await currentHandler(req, res, next);
+            }
+            catch (error) {
+                console.error("[angular-plugin-ui-bundle] Proxy handler error:", error);
+                if (next)
+                    next();
+            }
+        }
+        else {
+            // No manifest loaded — 503 for API requests, pass through for others
+            if (req.url?.startsWith("/services")) {
+                res.writeHead(503, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Proxy not initialized" }));
+                return;
+            }
+            if (next)
+                next();
+        }
+    };
+    return middleware;
+}

package/dist/plugins/api-version.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { Plugin } from "esbuild";
+import type { SalesforceOptions } from "../types.ts";
+export interface ApiVersionResult {
+    plugin: Plugin;
+    version: string;
+}
+/**
+ * esbuild plugin that substitutes __SF_API_VERSION__ at build time.
+ * Wired into angular.json plugins[] via @angular-builders/custom-esbuild.
+ *
+ * Returns { plugin, version } because esbuild rejects unknown properties
+ * on Plugin objects — version is exposed separately for bin/serve.ts to
+ * forward via --define.
+ */
+export declare function createApiVersionPlugin(options?: SalesforceOptions): Promise<ApiVersionResult>;
+//# sourceMappingURL=api-version.d.ts.map

package/dist/plugins/api-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-version.d.ts","sourceRoot":"","sources":["../../src/plugins/api-version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,SAAS,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,GAAE,iBAAsB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAgB3B"}

package/dist/plugins/api-version.js

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { resolveApiVersion } from "../api-version.js";
+/**
+ * esbuild plugin that substitutes __SF_API_VERSION__ at build time.
+ * Wired into angular.json plugins[] via @angular-builders/custom-esbuild.
+ *
+ * Returns { plugin, version } because esbuild rejects unknown properties
+ * on Plugin objects — version is exposed separately for bin/serve.ts to
+ * forward via --define.
+ */
+export async function createApiVersionPlugin(options = {}) {
+    const version = await resolveApiVersion(options.orgAlias);
+    if (options.debug) {
+        console.log(`[angular-plugin-ui-bundle] API version resolved: ${version}`);
+    }
+    const plugin = {
+        name: "@salesforce/angular-plugin-ui-bundle:api-version",
+        setup(build) {
+            build.initialOptions.define ??= {};
+            build.initialOptions.define["__SF_API_VERSION__"] = JSON.stringify(version);
+        },
+    };
+    return { plugin, version };
+}

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+export interface SalesforceOptions {
+    orgAlias?: string;
+    debug?: boolean;
+}
+export type Middleware = (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,CACxB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,KACzB,IAAI,CAAC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export {};

package/dist/utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export declare const DEFAULT_API_VERSION = "65.0";
+export declare const DEFAULT_PORT = 5173;
+export declare function getPort(): number;
+/** Extract path from Code Builder proxy URI. Same logic as vite-plugin-ui-bundle. */
+export declare function getCodeBuilderBasePath(proxyUri: string, port: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,qFAAqF;AACrF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ7E"}

package/dist/utils.js

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export const DEFAULT_API_VERSION = "65.0";
+export const DEFAULT_PORT = 5173;
+export function getPort() {
+    return parseInt(process.env.SF_UIBUNDLE_PORT || DEFAULT_PORT.toString(), 10);
+}
+/** Extract path from Code Builder proxy URI. Same logic as vite-plugin-ui-bundle. */
+export function getCodeBuilderBasePath(proxyUri, port) {
+    try {
+        const url = new URL(proxyUri.replace("{{port}}", port.toString()));
+        return url.pathname;
+    }
+    catch (error) {
+        console.error("Failed to parse CODE_BUILDER_FRAMEWORK_PROXY_URI:", error);
+        return `/absproxy/${port}`;
+    }
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@salesforce/angular-plugin-ui-bundle",
+  "description": "Angular CLI plugin for Salesforce UI Bundles",
+  "version": "10.23.0",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "sf-angular-serve": "./dist/bin/serve.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@salesforce/ui-bundle": "^10.23.0",
+    "chokidar": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.9.2",
+    "esbuild": "^0.27.4",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.6"
+  },
+  "peerDependencies": {
+    "@angular-builders/custom-esbuild": "^21.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}