@simplysf/simply-community-core 0.1.0

package/LICENSE.txt

@@ -0,0 +1,206 @@
+Apache License Version 2.0
+
+Copyright (c) 2026, Clay Chipps.
+All rights reserved.
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright {yyyy} {name of copyright owner}
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,70 @@
+# @simplysf/simply-community-core
+
+[![NPM](https://img.shields.io/npm/v/@simplysf/simply-community-core?label=@simplysf/simply-community-core)](https://npmjs.com/@simplysf/simply-community-core) [![Downloads/week](https://img.shields.io/npm/dw/@simplysf/simply-community-core.svg)](https://npmjs.com/@simplysf/simply-community-core) [![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://raw.githubusercontent.com/SimplySF/simply-node/main/LICENSE.txt)
+
+Community publish/deploy/domain-verification logic and site-file discovery. This is not a Salesforce CLI plugin — it's the library layer behind [`@simplysf/simply-community`](https://github.com/SimplySF/simply-plugins/tree/main/packages/simply-community)'s publish/URL commands, published separately so it can be imported directly by anything that wants the same logic (an editor extension, a CI job, a script) without pulling in the CLI framework.
+
+## Install
+
+```bash
+npm install @simplysf/simply-community-core
+```
+
+Requires Node.js `>=22` and either `"type": "module"` or a dynamic `import()` — this package ships ESM only.
+
+## API
+
+Everything below is exported from the package root. Removing or renaming an export is a breaking change; see [`src/index.ts`](src/index.ts).
+
+| Export                                                  | Description                                                                                     |
+| ------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| `publishCommunity(options)`                             | Triggers a community publish via the Connect REST API and polls until it completes.             |
+| `checkPublishStatus(connection, jobId)`                 | Builds the `PollingClient`-compatible poll function `publishCommunity` uses.                    |
+| `deployChangedFiles(options)`                           | Deploys a specific file list and polls until the deploy reaches a terminal state.               |
+| `retrieveCustomSite(connection, site, outputDirectory)` | Retrieves a single `CustomSite` component by name.                                              |
+| `resolveSearchRoots(directory?, projectDir?)`           | Resolves the root directories a site/network lookup should search under.                        |
+| `resolveRetrieveDestination(directory?, projectDir?)`   | Resolves the single directory a retrieve should write into.                                     |
+| `resolveSiteFile(site, roots)`                          | Finds the `sites/<site>.site-meta.xml` file for a CustomSite API name.                          |
+| `resolveNetworkFile(site, roots)`                       | Finds the `networks/*.network-meta.xml` file whose `<site>` element names a CustomSite.         |
+| `patchCustomSiteXml(xml, options)`                      | Pure function: replaces a `CustomSite` metadata document's custom URLs with exactly one.        |
+| `patchNetworkXml(xml, pathPrefix)`                      | Pure function: patches a `Network` metadata document's `urlPathPrefix`.                         |
+| `readNetworkSiteName(xml)`                              | Pure function: reads a `Network` metadata document's `<site>` element.                          |
+| `verifyDomain(connection, domain)`                      | Checks whether a custom domain is registered in the target org, and what it's already bound to. |
+
+```ts
+import { publishCommunity } from '@simplysf/simply-community-core';
+
+const result = await publishCommunity({ connection, networkId: '0DM000000000001', wait: 10 });
+```
+
+```ts
+import { resolveSearchRoots, resolveSiteFile } from '@simplysf/simply-community-core';
+
+const roots = await resolveSearchRoots(undefined, process.cwd());
+const siteFile = await resolveSiteFile('MySite', roots);
+```
+
+```ts
+import { patchCustomSiteXml } from '@simplysf/simply-community-core';
+
+const currentXml = await fs.readFile(siteFile, 'utf-8');
+const { xml, previousDomains } = patchCustomSiteXml(currentXml, { domain: 'my.example.com', primary: true });
+```
+
+```ts
+import { verifyDomain } from '@simplysf/simply-community-core';
+
+const check = await verifyDomain(connection, 'my.example.com');
+```
+
+## Issues
+
+Please report any issues at https://github.com/SimplySF/simply-node/issues
+
+## Contributing
+
+This package is part of the [`@simplysf/simply`](https://github.com/SimplySF/simply-node) monorepo. See [CONTRIBUTING.md](CONTRIBUTING.md) for what's specific to this package, and the repo's [root CONTRIBUTING.md](https://github.com/SimplySF/simply-node/blob/main/CONTRIBUTING.md) for repo structure, setup, commit conventions, and how to submit a pull request. Please also read our [Code of Conduct](https://github.com/SimplySF/simply-node/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+Licensed under the [Apache-2.0](https://raw.githubusercontent.com/SimplySF/simply-node/main/LICENSE.txt) license.

package/lib/checkPublishStatus.d.ts

@@ -0,0 +1,15 @@
+import { type Connection, type StatusResult } from '@salesforce/core';
+/**
+ * Builds a `PollingClient`-compatible `poll()` function for a community publish job.
+ *
+ * `BackgroundOperation.FinishedAt` (populated once the job reaches a terminal state) is used as
+ * the completion signal rather than matching specific `Status` picklist values, since that's a
+ * reliable signal regardless of exact status wording. `Error` (populated on failure) determines
+ * success vs. failure once finished.
+ *
+ * @param connection - The org connection to poll against.
+ * @param jobId - The `jobId` returned by `POST /connect/communities/{id}/publish`.
+ * @returns A `poll()` function for `PollingClient.create({ poll, ... })`.
+ * @throws {SfError} `CommunityPublishFailedError` if the job reaches a terminal failure state.
+ */
+export declare function checkPublishStatus(connection: Connection, jobId: string): () => Promise<StatusResult>;

package/lib/checkPublishStatus.js

@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { SfError } from '@salesforce/core';
+/**
+ * Builds a `PollingClient`-compatible `poll()` function for a community publish job.
+ *
+ * `BackgroundOperation.FinishedAt` (populated once the job reaches a terminal state) is used as
+ * the completion signal rather than matching specific `Status` picklist values, since that's a
+ * reliable signal regardless of exact status wording. `Error` (populated on failure) determines
+ * success vs. failure once finished.
+ *
+ * @param connection - The org connection to poll against.
+ * @param jobId - The `jobId` returned by `POST /connect/communities/{id}/publish`.
+ * @returns A `poll()` function for `PollingClient.create({ poll, ... })`.
+ * @throws {SfError} `CommunityPublishFailedError` if the job reaches a terminal failure state.
+ */
+export function checkPublishStatus(connection, jobId) {
+    return async () => {
+        const result = await connection.query(`SELECT Id, Status, FinishedAt, Error FROM BackgroundOperation WHERE Id = '${jobId}'`);
+        const operation = result.records[0];
+        // The BackgroundOperation record may not be queryable in the instant right after the publish
+        // request is submitted — treat "not found yet" the same as "still running", not as a failure.
+        if (!operation?.FinishedAt) {
+            return { completed: false };
+        }
+        if (operation.Error) {
+            throw new SfError(`Community publish failed (status: ${operation.Status ?? 'unknown'}): ${operation.Error}`, 'CommunityPublishFailedError');
+        }
+        return { completed: true, payload: { status: operation.Status } };
+    };
+}
+//# sourceMappingURL=checkPublishStatus.js.map

package/lib/checkPublishStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkPublishStatus.js","sourceRoot":"","sources":["../src/checkPublishStatus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAsC,MAAM,kBAAkB,CAAC;AAU/E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAsB,EAAE,KAAa;IACtE,OAAO,KAAK,IAA2B,EAAE;QACvC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CACnC,6EAA6E,KAAK,GAAG,CACtF,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAA0C,CAAC;QAE7E,6FAA6F;QAC7F,8FAA8F;QAC9F,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC;YAC3B,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;QAED,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,IAAI,OAAO,CACf,qCAAqC,SAAS,CAAC,MAAM,IAAI,SAAS,MAAM,SAAS,CAAC,KAAK,EAAE,EACzF,6BAA6B,CAC9B,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;IACpE,CAAC,CAAC;AACJ,CAAC"}

package/lib/deployChangedFiles.d.ts

@@ -0,0 +1,37 @@
+import type { Connection } from '@salesforce/core';
+import type { Duration } from '@salesforce/kit';
+export type DeployChangedFilesOptions = {
+    connection: Connection;
+    /** The exact files the command just wrote — the component set is scoped to only these. */
+    filePaths: string[];
+    wait: Duration;
+};
+export type DeployComponentFailure = {
+    fullName: string;
+    type: string;
+    filePath?: string;
+    error: string;
+};
+export type DeployChangedFilesResult = {
+    id: string;
+    status: string;
+    success: boolean;
+    componentsDeployed: string[];
+    failures: DeployComponentFailure[];
+};
+/**
+ * Deploy exactly the given files and poll until the deploy reaches a terminal state.
+ *
+ * Scoped to `filePaths` rather than a whole directory: the command already knows precisely which
+ * one or two files it just patched, so the component set is built from that list instead of
+ * rediscovering it from `--directory`.
+ *
+ * Does not throw on a failed deploy — a failure is reported in the returned result (`success:
+ * false`, populated `failures`) so the caller's restore `finally` still runs before it decides
+ * whether to throw. An error here means the deploy request or polling itself broke (auth,
+ * network, timeout), not that components failed to deploy.
+ *
+ * @param options - The connection to deploy against, the changed files, and how long to wait.
+ * @returns The deploy outcome: id, terminal status, and per-component successes/failures.
+ */
+export declare function deployChangedFiles(options: DeployChangedFilesOptions): Promise<DeployChangedFilesResult>;

package/lib/deployChangedFiles.js

@@ -0,0 +1,59 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ComponentSet, ComponentStatus } from '@salesforce/source-deploy-retrieve';
+/**
+ * Deploy exactly the given files and poll until the deploy reaches a terminal state.
+ *
+ * Scoped to `filePaths` rather than a whole directory: the command already knows precisely which
+ * one or two files it just patched, so the component set is built from that list instead of
+ * rediscovering it from `--directory`.
+ *
+ * Does not throw on a failed deploy — a failure is reported in the returned result (`success:
+ * false`, populated `failures`) so the caller's restore `finally` still runs before it decides
+ * whether to throw. An error here means the deploy request or polling itself broke (auth,
+ * network, timeout), not that components failed to deploy.
+ *
+ * @param options - The connection to deploy against, the changed files, and how long to wait.
+ * @returns The deploy outcome: id, terminal status, and per-component successes/failures.
+ */
+export async function deployChangedFiles(options) {
+    const componentSet = ComponentSet.fromSource(options.filePaths);
+    const deploy = await componentSet.deploy({ usernameOrConnection: options.connection });
+    const result = await deploy.pollStatus({ timeout: options.wait });
+    const failures = [];
+    const componentsDeployed = [];
+    for (const fileResponse of result.getFileResponses()) {
+        if (fileResponse.state === ComponentStatus.Failed) {
+            failures.push({
+                fullName: fileResponse.fullName,
+                type: fileResponse.type,
+                filePath: fileResponse.filePath,
+                error: fileResponse.error,
+            });
+        }
+        else {
+            componentsDeployed.push(fileResponse.fullName);
+        }
+    }
+    return {
+        id: result.response.id,
+        status: result.response.status,
+        success: result.response.success,
+        componentsDeployed,
+        failures,
+    };
+}
+//# sourceMappingURL=deployChangedFiles.js.map

package/lib/deployChangedFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployChangedFiles.js","sourceRoot":"","sources":["../src/deployChangedFiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAwBnF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAkC;IACzE,MAAM,YAAY,GAAG,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAElE,MAAM,QAAQ,GAA6B,EAAE,CAAC;IAC9C,MAAM,kBAAkB,GAAa,EAAE,CAAC;IAExC,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,gBAAgB,EAAE,EAAE,CAAC;QACrD,IAAI,YAAY,CAAC,KAAK,KAAK,eAAe,CAAC,MAAM,EAAE,CAAC;YAClD,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,YAAY,CAAC,QAAQ;gBAC/B,IAAI,EAAE,YAAY,CAAC,IAAI;gBACvB,QAAQ,EAAE,YAAY,CAAC,QAAQ;gBAC/B,KAAK,EAAE,YAAY,CAAC,KAAK;aAC1B,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;QAC9B,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO;QAChC,kBAAkB;QAClB,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,7 @@
+export { checkPublishStatus } from './checkPublishStatus.js';
+export { deployChangedFiles, type DeployChangedFilesOptions, type DeployComponentFailure, type DeployChangedFilesResult, } from './deployChangedFiles.js';
+export { publishCommunity, type PublishCommunityOptions } from './publishCommunity.js';
+export { resolveSearchRoots, resolveRetrieveDestination, resolveSiteFile, resolveNetworkFile, } from './resolveSiteFiles.js';
+export { retrieveCustomSite } from './retrieveCustomSite.js';
+export { patchCustomSiteXml, type PatchCustomSiteXmlOptions, type PatchCustomSiteXmlResult, patchNetworkXml, readNetworkSiteName, } from './siteMetadataXml.js';
+export { verifyDomain, type DomainCheckStatus, type DomainCheckResult } from './verifyDomain.js';

package/lib/index.js

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Everything exported from this file is this package's public API and is semver-covered: adding an
+// export is a minor/patch change, but removing or renaming one is breaking. `test/index.test.ts`
+// pins the exported-key list down so an accidental removal fails a test instead of silently shipping
+// in a patch release. See docs/design/0030-simply-community-core.md for why this package is split
+// out from `@simplysf/simply-community` (the CLI) rather than being one more relative import inside
+// it.
+export { checkPublishStatus } from './checkPublishStatus.js';
+export { deployChangedFiles, } from './deployChangedFiles.js';
+export { publishCommunity } from './publishCommunity.js';
+export { resolveSearchRoots, resolveRetrieveDestination, resolveSiteFile, resolveNetworkFile, } from './resolveSiteFiles.js';
+export { retrieveCustomSite } from './retrieveCustomSite.js';
+export { patchCustomSiteXml, patchNetworkXml, readNetworkSiteName, } from './siteMetadataXml.js';
+export { verifyDomain } from './verifyDomain.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,mGAAmG;AACnG,iGAAiG;AACjG,qGAAqG;AACrG,kGAAkG;AAClG,oGAAoG;AACpG,MAAM;AAEN,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,kBAAkB,GAInB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAgC,MAAM,uBAAuB,CAAC;AACvF,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,eAAe,EACf,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,kBAAkB,EAGlB,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAkD,MAAM,mBAAmB,CAAC"}

package/lib/publishCommunity.d.ts

@@ -0,0 +1,33 @@
+import type { Connection } from '@salesforce/core';
+/** The response shape of `POST /connect/communities/{id}/publish`. */
+type CommunityPublishResponse = {
+    id: string;
+    jobId: string;
+    name: string;
+    url: string;
+};
+export type PublishCommunityOptions = {
+    connection: Connection;
+    /** The `Network.Id` to publish. */
+    networkId: string;
+    /** Minutes to wait for the publish job to reach a terminal state. */
+    wait: number;
+    /** Additional attempts to make if the initial publish request fails. Defaults to 0. */
+    retryAttempts?: number;
+    /** Factor the retry delay grows by after each failed attempt. Defaults to 2. */
+    retryBackoff?: number;
+};
+/**
+ * Trigger a community publish via the Connect REST API and poll until the job reaches a terminal
+ * state, throwing if it fails.
+ *
+ * Shared by `simply community publish` and `simply community url set --publish` so the Connect
+ * API call and the poll for completion exist in exactly one place.
+ *
+ * @param options - The connection, the `Network.Id` to publish, and wait/retry settings.
+ * @returns The Connect API's publish response: id, jobId, name, and url.
+ * @throws {SfError} `CommunityPublishFailedError` if the job reaches a terminal failure state.
+ * @throws If the initial publish request fails and retries (if any) are exhausted.
+ */
+export declare function publishCommunity(options: PublishCommunityOptions): Promise<CommunityPublishResponse>;
+export {};

package/lib/publishCommunity.js

@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Duration } from '@salesforce/kit';
+import { PollingClient } from '@salesforce/core';
+import { retryWithBackoff } from '@simplysf/simply-core';
+import { checkPublishStatus } from './checkPublishStatus.js';
+/**
+ * Trigger a community publish via the Connect REST API and poll until the job reaches a terminal
+ * state, throwing if it fails.
+ *
+ * Shared by `simply community publish` and `simply community url set --publish` so the Connect
+ * API call and the poll for completion exist in exactly one place.
+ *
+ * @param options - The connection, the `Network.Id` to publish, and wait/retry settings.
+ * @returns The Connect API's publish response: id, jobId, name, and url.
+ * @throws {SfError} `CommunityPublishFailedError` if the job reaches a terminal failure state.
+ * @throws If the initial publish request fails and retries (if any) are exhausted.
+ */
+export async function publishCommunity(options) {
+    const publishResponse = await retryWithBackoff(async () => options.connection.request({
+        method: 'POST',
+        url: `/connect/communities/${options.networkId}/publish`,
+    }), { retryAttempts: options.retryAttempts ?? 0, backoffFactor: options.retryBackoff ?? 2 });
+    const client = await PollingClient.create({
+        poll: checkPublishStatus(options.connection, publishResponse.jobId),
+        frequency: Duration.seconds(15),
+        timeout: Duration.minutes(options.wait),
+        timeoutErrorName: 'CommunityPublishTimeoutError',
+    });
+    await client.subscribe();
+    return publishResponse;
+}
+//# sourceMappingURL=publishCommunity.js.map

package/lib/publishCommunity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishCommunity.js","sourceRoot":"","sources":["../src/publishCommunity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAiB7D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAgC;IACrE,MAAM,eAAe,GAAG,MAAM,gBAAgB,CAC5C,KAAK,IAAI,EAAE,CACT,OAAO,CAAC,UAAU,CAAC,OAAO,CAA2B;QACnD,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,wBAAwB,OAAO,CAAC,SAAS,UAAU;KACzD,CAAC,EACJ,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC,EAAE,CACxF,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC;QACxC,IAAI,EAAE,kBAAkB,CAAC,OAAO,CAAC,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC;QACnE,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QACvC,gBAAgB,EAAE,8BAA8B;KACjD,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IAEzB,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/lib/resolveSiteFiles.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Resolve the root directories a site/network lookup should search under.
+ *
+ * When `--directory` is given, it's the sole root. Otherwise every package directory declared in
+ * `sfdx-project.json` is searched — a project can (and often does) spread `sites`/`networks`
+ * across more than one package directory.
+ *
+ * @param directory - The `--directory` flag value, if given.
+ * @param projectDir - Directory to read `sfdx-project.json` from. Defaults to the current working
+ * directory, matching `readSfdxProject`.
+ * @returns Absolute root directories to search.
+ */
+export declare function resolveSearchRoots(directory?: string, projectDir?: string): Promise<string[]>;
+/**
+ * Resolve the single directory a retrieve should write into, when the site file wasn't found
+ * among {@link resolveSearchRoots}'s (possibly multiple) roots.
+ *
+ * Unlike search, retrieval needs exactly one destination: `--directory` if given, otherwise the
+ * project's default package directory — the same directory a plain `sf project retrieve start`
+ * would use absent other guidance.
+ *
+ * @param directory - The `--directory` flag value, if given.
+ * @param projectDir - Directory to read `sfdx-project.json` from. Defaults to the current working
+ * directory, matching `readSfdxProject`.
+ * @returns The absolute destination directory.
+ * @throws {SfError} `CommunityUrlNoRetrieveDestinationError` if `--directory` wasn't given and the
+ * project has no default package directory to fall back to.
+ */
+export declare function resolveRetrieveDestination(directory?: string, projectDir?: string): Promise<string>;
+/**
+ * Find the `sites/<site>.site-meta.xml` file for a CustomSite API name.
+ *
+ * @param site - The CustomSite API name (the basename of the site file, without its extension).
+ * @param roots - Root directories to search, from {@link resolveSearchRoots}.
+ * @returns The absolute path to the matched site file.
+ * @throws {SfError} `CommunityUrlSiteFileNotFoundError` if no file matches.
+ * @throws {SfError} `CommunityUrlSiteFileAmbiguousError` if more than one file matches.
+ */
+export declare function resolveSiteFile(site: string, roots: string[]): Promise<string>;
+/**
+ * Find the `networks/*.network-meta.xml` file whose `<site>` element names a CustomSite.
+ *
+ * Every `.network-meta.xml` file under the search roots is opened to check its `<site>` value,
+ * since the Network's own file name doesn't have to match the CustomSite's API name.
+ *
+ * @param site - The CustomSite API name to search for.
+ * @param roots - Root directories to search, from {@link resolveSearchRoots}.
+ * @returns The absolute path to the matched network file.
+ * @throws {SfError} `CommunityUrlNetworkFileNotFoundError` if no file's `<site>` matches.
+ * @throws {SfError} `CommunityUrlNetworkFileAmbiguousError` if more than one file's `<site>` matches.
+ */
+export declare function resolveNetworkFile(site: string, roots: string[]): Promise<string>;

package/lib/resolveSiteFiles.js

@@ -0,0 +1,122 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { glob } from 'glob';
+import { SfError } from '@salesforce/core';
+import { getDefaultPackageDirectory, readSfdxProject } from '@simplysf/simply-core';
+import { readNetworkSiteName } from './siteMetadataXml.js';
+/** Normalize a filesystem path to forward slashes, which is what `glob` patterns expect. */
+function toGlobPath(fsPath) {
+    return fsPath.split(path.sep).join('/');
+}
+/**
+ * Resolve the root directories a site/network lookup should search under.
+ *
+ * When `--directory` is given, it's the sole root. Otherwise every package directory declared in
+ * `sfdx-project.json` is searched — a project can (and often does) spread `sites`/`networks`
+ * across more than one package directory.
+ *
+ * @param directory - The `--directory` flag value, if given.
+ * @param projectDir - Directory to read `sfdx-project.json` from. Defaults to the current working
+ * directory, matching `readSfdxProject`.
+ * @returns Absolute root directories to search.
+ */
+export async function resolveSearchRoots(directory, projectDir = process.cwd()) {
+    if (directory) {
+        return [path.resolve(directory)];
+    }
+    const project = await readSfdxProject(projectDir);
+    return project.packageDirectories.map((packageDirectory) => path.resolve(projectDir, packageDirectory.path ?? '.'));
+}
+/**
+ * Resolve the single directory a retrieve should write into, when the site file wasn't found
+ * among {@link resolveSearchRoots}'s (possibly multiple) roots.
+ *
+ * Unlike search, retrieval needs exactly one destination: `--directory` if given, otherwise the
+ * project's default package directory — the same directory a plain `sf project retrieve start`
+ * would use absent other guidance.
+ *
+ * @param directory - The `--directory` flag value, if given.
+ * @param projectDir - Directory to read `sfdx-project.json` from. Defaults to the current working
+ * directory, matching `readSfdxProject`.
+ * @returns The absolute destination directory.
+ * @throws {SfError} `CommunityUrlNoRetrieveDestinationError` if `--directory` wasn't given and the
+ * project has no default package directory to fall back to.
+ */
+export async function resolveRetrieveDestination(directory, projectDir = process.cwd()) {
+    if (directory) {
+        return path.resolve(directory);
+    }
+    const project = await readSfdxProject(projectDir);
+    const defaultPackageDirectory = getDefaultPackageDirectory(project);
+    if (!defaultPackageDirectory?.path) {
+        throw new SfError('No --directory was given, and the project has no default package directory to retrieve into.', 'CommunityUrlNoRetrieveDestinationError');
+    }
+    return path.resolve(projectDir, defaultPackageDirectory.path);
+}
+/**
+ * Find the `sites/<site>.site-meta.xml` file for a CustomSite API name.
+ *
+ * @param site - The CustomSite API name (the basename of the site file, without its extension).
+ * @param roots - Root directories to search, from {@link resolveSearchRoots}.
+ * @returns The absolute path to the matched site file.
+ * @throws {SfError} `CommunityUrlSiteFileNotFoundError` if no file matches.
+ * @throws {SfError} `CommunityUrlSiteFileAmbiguousError` if more than one file matches.
+ */
+export async function resolveSiteFile(site, roots) {
+    const patterns = roots.map((root) => `${toGlobPath(root)}/**/sites/${site}.site-meta.xml`);
+    const matches = [...new Set((await Promise.all(patterns.map((pattern) => glob(pattern)))).flat())];
+    if (matches.length === 0) {
+        throw new SfError(`No site file found matching any of: ${patterns.join(', ')}`, 'CommunityUrlSiteFileNotFoundError');
+    }
+    if (matches.length > 1) {
+        throw new SfError(`Multiple site files matched "${site}": ${matches.join(', ')}`, 'CommunityUrlSiteFileAmbiguousError');
+    }
+    return matches[0];
+}
+/**
+ * Find the `networks/*.network-meta.xml` file whose `<site>` element names a CustomSite.
+ *
+ * Every `.network-meta.xml` file under the search roots is opened to check its `<site>` value,
+ * since the Network's own file name doesn't have to match the CustomSite's API name.
+ *
+ * @param site - The CustomSite API name to search for.
+ * @param roots - Root directories to search, from {@link resolveSearchRoots}.
+ * @returns The absolute path to the matched network file.
+ * @throws {SfError} `CommunityUrlNetworkFileNotFoundError` if no file's `<site>` matches.
+ * @throws {SfError} `CommunityUrlNetworkFileAmbiguousError` if more than one file's `<site>` matches.
+ */
+export async function resolveNetworkFile(site, roots) {
+    const patterns = roots.map((root) => `${toGlobPath(root)}/**/networks/*.network-meta.xml`);
+    const candidates = [...new Set((await Promise.all(patterns.map((pattern) => glob(pattern)))).flat())];
+    const matches = [];
+    for (const candidate of candidates) {
+        // eslint-disable-next-line no-await-in-loop
+        const xml = await fs.readFile(candidate, 'utf-8');
+        if (readNetworkSiteName(xml) === site) {
+            matches.push(candidate);
+        }
+    }
+    if (matches.length === 0) {
+        throw new SfError(`No network file found whose <site> element is "${site}" under: ${patterns.join(', ')}`, 'CommunityUrlNetworkFileNotFoundError');
+    }
+    if (matches.length > 1) {
+        throw new SfError(`Multiple network files reference site "${site}": ${matches.join(', ')}`, 'CommunityUrlNetworkFileAmbiguousError');
+    }
+    return matches[0];
+}
+//# sourceMappingURL=resolveSiteFiles.js.map

package/lib/resolveSiteFiles.js.map

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

package/lib/retrieveCustomSite.d.ts

@@ -0,0 +1,21 @@
+import type { Connection } from '@salesforce/core';
+/**
+ * Retrieve a single `CustomSite` component by name into a destination directory.
+ *
+ * Used when the site file isn't found locally (see `resolveSiteFile`) but a `--target-org`
+ * connection is available — the fallback that lets the command work against a checkout that never
+ * had `sites/` committed at all.
+ *
+ * The component set is built directly from `{ fullName, type: 'CustomSite' }` rather than resolved
+ * from source, since there's nothing on disk yet for this component; `merge: true` is passed
+ * anyway so a same-named file elsewhere under `outputDirectory` gets merged into rather than
+ * duplicated, on the off chance the local search missed something the registry wouldn't.
+ *
+ * @param connection - The org connection to retrieve from.
+ * @param site - The CustomSite API name to retrieve.
+ * @param outputDirectory - Where to write the retrieved file, from `resolveRetrieveDestination`.
+ * @returns The retrieved file's path, or `undefined` if the org has no `CustomSite` by that name.
+ * @throws If the retrieve request or polling itself fails (auth, network, timeout) — only "the
+ * component doesn't exist" is reported as `undefined` rather than thrown.
+ */
+export declare function retrieveCustomSite(connection: Connection, site: string, outputDirectory: string): Promise<string | undefined>;

package/lib/retrieveCustomSite.js

@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ComponentSet, ComponentStatus } from '@salesforce/source-deploy-retrieve';
+/**
+ * Retrieve a single `CustomSite` component by name into a destination directory.
+ *
+ * Used when the site file isn't found locally (see `resolveSiteFile`) but a `--target-org`
+ * connection is available — the fallback that lets the command work against a checkout that never
+ * had `sites/` committed at all.
+ *
+ * The component set is built directly from `{ fullName, type: 'CustomSite' }` rather than resolved
+ * from source, since there's nothing on disk yet for this component; `merge: true` is passed
+ * anyway so a same-named file elsewhere under `outputDirectory` gets merged into rather than
+ * duplicated, on the off chance the local search missed something the registry wouldn't.
+ *
+ * @param connection - The org connection to retrieve from.
+ * @param site - The CustomSite API name to retrieve.
+ * @param outputDirectory - Where to write the retrieved file, from `resolveRetrieveDestination`.
+ * @returns The retrieved file's path, or `undefined` if the org has no `CustomSite` by that name.
+ * @throws If the retrieve request or polling itself fails (auth, network, timeout) — only "the
+ * component doesn't exist" is reported as `undefined` rather than thrown.
+ */
+export async function retrieveCustomSite(connection, site, outputDirectory) {
+    const componentSet = new ComponentSet([{ fullName: site, type: 'CustomSite' }]);
+    const operation = await componentSet.retrieve({
+        usernameOrConnection: connection,
+        output: outputDirectory,
+        merge: true,
+    });
+    const result = await operation.pollStatus();
+    const fileResponse = result
+        .getFileResponses()
+        .find((response) => response.type === 'CustomSite' && response.fullName === site);
+    if (!fileResponse || fileResponse.state === ComponentStatus.Failed) {
+        return undefined;
+    }
+    return fileResponse.filePath;
+}
+//# sourceMappingURL=retrieveCustomSite.js.map

package/lib/retrieveCustomSite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieveCustomSite.js","sourceRoot":"","sources":["../src/retrieveCustomSite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAEnF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAsB,EACtB,IAAY,EACZ,eAAuB;IAEvB,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;IAChF,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC;QAC5C,oBAAoB,EAAE,UAAU;QAChC,MAAM,EAAE,eAAe;QACvB,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC;IAE5C,MAAM,YAAY,GAAG,MAAM;SACxB,gBAAgB,EAAE;SAClB,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;IAEpF,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,KAAK,KAAK,eAAe,CAAC,MAAM,EAAE,CAAC;QACnE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,YAAY,CAAC,QAAQ,CAAC;AAC/B,CAAC"}

package/lib/siteMetadataXml.d.ts

@@ -0,0 +1,42 @@
+/** What `patchCustomSiteXml` should write into `sites/<Site>.site-meta.xml`. */
+export type PatchCustomSiteXmlOptions = {
+    domain: string;
+    primary: boolean;
+    pathPrefix?: string;
+};
+export type PatchCustomSiteXmlResult = {
+    xml: string;
+    /** The `domainName` values of every `customWebAddresses` entry the replace-all discarded. */
+    previousDomains: string[];
+};
+/**
+ * Patch a `CustomSite` metadata document: replace every `customWebAddresses` entry with exactly
+ * one, and optionally set `urlPathPrefix`.
+ *
+ * Per the CustomSite metadata reference, saving or deploying a CustomSite replaces all root
+ * custom URLs with the list being written — so this replaces rather than appends, matching what
+ * the deploy is going to do regardless.
+ *
+ * @param xml - The current contents of the `sites/<Site>.site-meta.xml` file.
+ * @param options - The domain (and whether it's primary) to write, and an optional path prefix.
+ * @returns The rewritten document, plus the domains the replace-all discarded.
+ * @throws {Error} If `xml` isn't parseable.
+ */
+export declare function patchCustomSiteXml(xml: string, options: PatchCustomSiteXmlOptions): PatchCustomSiteXmlResult;
+/**
+ * Patch a `Network` metadata document's `urlPathPrefix`.
+ *
+ * @param xml - The current contents of the `networks/<Network>.network-meta.xml` file.
+ * @param pathPrefix - The URL path prefix to write.
+ * @returns The rewritten document.
+ * @throws {Error} If `xml` isn't parseable.
+ */
+export declare function patchNetworkXml(xml: string, pathPrefix: string): string;
+/**
+ * Read a `Network` metadata document's `<site>` element — the CustomSite API name it belongs to.
+ *
+ * @param xml - The contents of a `networks/*.network-meta.xml` file.
+ * @returns The `<site>` value, or `undefined` if the element is absent.
+ * @throws {Error} If `xml` isn't parseable.
+ */
+export declare function readNetworkSiteName(xml: string): string | undefined;

package/lib/siteMetadataXml.js

@@ -0,0 +1,100 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { create } from 'xmlbuilder2';
+/**
+ * Find the direct child elements of `root` with the given tag name.
+ *
+ * `filter`'s second argument (`self`) excludes `root` itself from consideration, and the third
+ * (`recursive`) is left `false` so a same-named descendant nested under an unrelated element
+ * (there are none today, but the metadata schema isn't ours to fix) can't be matched by mistake.
+ */
+function childrenNamed(root, tagName) {
+    return root.filter((node) => node.node.nodeName === tagName, false, false);
+}
+/**
+ * Patch a `CustomSite` metadata document: replace every `customWebAddresses` entry with exactly
+ * one, and optionally set `urlPathPrefix`.
+ *
+ * Per the CustomSite metadata reference, saving or deploying a CustomSite replaces all root
+ * custom URLs with the list being written — so this replaces rather than appends, matching what
+ * the deploy is going to do regardless.
+ *
+ * @param xml - The current contents of the `sites/<Site>.site-meta.xml` file.
+ * @param options - The domain (and whether it's primary) to write, and an optional path prefix.
+ * @returns The rewritten document, plus the domains the replace-all discarded.
+ * @throws {Error} If `xml` isn't parseable.
+ */
+export function patchCustomSiteXml(xml, options) {
+    const doc = create(xml);
+    const root = doc.root();
+    const previousDomains = [];
+    for (const node of childrenNamed(root, 'customWebAddresses')) {
+        const domainNameNode = childrenNamed(node, 'domainName')[0];
+        if (domainNameNode?.node.textContent) {
+            previousDomains.push(domainNameNode.node.textContent);
+        }
+        node.remove();
+    }
+    root
+        .ele('customWebAddresses')
+        .ele('domainName')
+        .txt(options.domain)
+        .up()
+        .ele('primary')
+        .txt(String(options.primary))
+        .up()
+        .up();
+    if (options.pathPrefix !== undefined) {
+        setUrlPathPrefix(root, options.pathPrefix);
+    }
+    return { xml: doc.end({ prettyPrint: true }), previousDomains };
+}
+/**
+ * Patch a `Network` metadata document's `urlPathPrefix`.
+ *
+ * @param xml - The current contents of the `networks/<Network>.network-meta.xml` file.
+ * @param pathPrefix - The URL path prefix to write.
+ * @returns The rewritten document.
+ * @throws {Error} If `xml` isn't parseable.
+ */
+export function patchNetworkXml(xml, pathPrefix) {
+    const doc = create(xml);
+    const root = doc.root();
+    setUrlPathPrefix(root, pathPrefix);
+    return doc.end({ prettyPrint: true });
+}
+/**
+ * Read a `Network` metadata document's `<site>` element — the CustomSite API name it belongs to.
+ *
+ * @param xml - The contents of a `networks/*.network-meta.xml` file.
+ * @returns The `<site>` value, or `undefined` if the element is absent.
+ * @throws {Error} If `xml` isn't parseable.
+ */
+export function readNetworkSiteName(xml) {
+    const root = create(xml).root();
+    return childrenNamed(root, 'site')[0]?.node.textContent ?? undefined;
+}
+/** Set `urlPathPrefix`'s text, creating the element (appended as the last child) if absent. */
+function setUrlPathPrefix(root, pathPrefix) {
+    const existing = childrenNamed(root, 'urlPathPrefix')[0];
+    if (existing) {
+        existing.node.textContent = pathPrefix;
+    }
+    else {
+        root.ele('urlPathPrefix').txt(pathPrefix).up();
+    }
+}
+//# sourceMappingURL=siteMetadataXml.js.map

package/lib/siteMetadataXml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"siteMetadataXml.js","sourceRoot":"","sources":["../src/siteMetadataXml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAgBrC;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,IAAgB,EAAE,OAAe;IACtD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,OAAkC;IAChF,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAExB,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,IAAI,EAAE,oBAAoB,CAAC,EAAE,CAAC;QAC7D,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,IAAI,cAAc,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,IAAI;SACD,GAAG,CAAC,oBAAoB,CAAC;SACzB,GAAG,CAAC,YAAY,CAAC;SACjB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;SACnB,EAAE,EAAE;SACJ,GAAG,CAAC,SAAS,CAAC;SACd,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;SAC5B,EAAE,EAAE;SACJ,EAAE,EAAE,CAAC;IAER,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC;AAClE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,UAAkB;IAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAExB,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAEnC,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAEhC,OAAO,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC;AACvE,CAAC;AAED,+FAA+F;AAC/F,SAAS,gBAAgB,CAAC,IAAgB,EAAE,UAAkB;IAC5D,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzD,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC;IACjD,CAAC;AACH,CAAC"}

package/lib/verifyDomain.d.ts

@@ -0,0 +1,27 @@
+import type { Connection } from '@salesforce/core';
+export type DomainCheckStatus = 'found' | 'missing' | 'unavailable';
+export type DomainCheckResult = {
+    status: DomainCheckStatus;
+    domainId?: string;
+    /** `SiteId` of every `DomainSite` this domain is already bound to. Empty when unbound. */
+    boundToSiteIds: string[];
+};
+/**
+ * Check whether a custom domain is registered in the target org, and what it's already bound to.
+ *
+ * `Domain` and `DomainSite` are read-only but SOQL-queryable (API 26.0+); they aren't in the
+ * source-deploy-retrieve metadata registry, so this is the only way to catch a typo'd or
+ * unregistered domain before a deploy fails with a less specific Salesforce-side error.
+ *
+ * Deliberately pure over a connection and a domain string — it doesn't know which site the
+ * caller intends to bind, so it can't itself decide whether `boundToSiteIds` is a problem. The
+ * caller compares those ids against whatever site it resolved and decides what's fatal.
+ *
+ * A query failure (missing permission, API error) is reported as `'unavailable'` rather than
+ * thrown, since an inability to run an advisory check isn't the same as the check failing.
+ *
+ * @param connection - The org connection to query against.
+ * @param domain - The fully qualified custom domain to look up.
+ * @returns Whether the domain was found, its Id, and the sites it's already bound to.
+ */
+export declare function verifyDomain(connection: Connection, domain: string): Promise<DomainCheckResult>;

package/lib/verifyDomain.js

@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2026, Clay Chipps.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { escapeSoqlLiteral } from '@simplysf/simply-core';
+/**
+ * Check whether a custom domain is registered in the target org, and what it's already bound to.
+ *
+ * `Domain` and `DomainSite` are read-only but SOQL-queryable (API 26.0+); they aren't in the
+ * source-deploy-retrieve metadata registry, so this is the only way to catch a typo'd or
+ * unregistered domain before a deploy fails with a less specific Salesforce-side error.
+ *
+ * Deliberately pure over a connection and a domain string — it doesn't know which site the
+ * caller intends to bind, so it can't itself decide whether `boundToSiteIds` is a problem. The
+ * caller compares those ids against whatever site it resolved and decides what's fatal.
+ *
+ * A query failure (missing permission, API error) is reported as `'unavailable'` rather than
+ * thrown, since an inability to run an advisory check isn't the same as the check failing.
+ *
+ * @param connection - The org connection to query against.
+ * @param domain - The fully qualified custom domain to look up.
+ * @returns Whether the domain was found, its Id, and the sites it's already bound to.
+ */
+export async function verifyDomain(connection, domain) {
+    try {
+        const result = await connection.query(`SELECT Id, Domain, DomainType, OptionsExternalHttps, CnameTarget, (SELECT Id, SiteId, PathPrefix FROM DomainSites) FROM Domain WHERE Domain = '${escapeSoqlLiteral(domain)}'`);
+        const record = result.records[0];
+        if (!record) {
+            return { status: 'missing', boundToSiteIds: [] };
+        }
+        return {
+            status: 'found',
+            domainId: record.Id,
+            boundToSiteIds: (record.DomainSites?.records ?? []).map((domainSite) => domainSite.SiteId),
+        };
+    }
+    catch {
+        return { status: 'unavailable', boundToSiteIds: [] };
+    }
+}
+//# sourceMappingURL=verifyDomain.js.map

package/lib/verifyDomain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyDomain.js","sourceRoot":"","sources":["../src/verifyDomain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAwB1D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAsB,EAAE,MAAc;IACvE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CACnC,kJAAkJ,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAC/K,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAEjC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;QACnD,CAAC;QAED,OAAO;YACL,MAAM,EAAE,OAAO;YACf,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,cAAc,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;SAC3F,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;IACvD,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,138 @@
+{
+  "name": "@simplysf/simply-community-core",
+  "description": "Community publish/deploy/domain-verification logic and site-file discovery — the library layer behind @simplysf/simply-community, published separately for direct consumption (e.g. editor tooling, CI scripts) without the CLI framework",
+  "version": "0.1.0",
+  "author": "@ClayChipps",
+  "homepage": "https://github.com/SimplySF/simply-node",
+  "bugs": "https://github.com/SimplySF/simply-node/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SimplySF/simply-node",
+    "directory": "packages/simply-community-core"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "files": [
+    "/lib"
+  ],
+  "keywords": [
+    "force",
+    "salesforce",
+    "sfdx",
+    "salesforcedx",
+    "sfdx-plugin",
+    "sf-plugin",
+    "sf",
+    "community",
+    "experience-cloud"
+  ],
+  "license": "Apache-2.0",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "type": "module",
+  "dependencies": {
+    "@salesforce/core": "^8.30.0",
+    "@salesforce/kit": "^3.2.6",
+    "@salesforce/source-deploy-retrieve": "^12.37.2",
+    "@simplysf/simply-core": "^1.5.1",
+    "glob": "^13.0.6",
+    "xmlbuilder2": "^4.0.3"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.10",
+    "vitest": "^4.1.10"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "wireit": {
+    "build": {
+      "dependencies": [
+        "compile",
+        "lint"
+      ]
+    },
+    "compile": {
+      "command": "tsc -p . --pretty --incremental",
+      "files": [
+        "src/**/*.ts",
+        "**/tsconfig.json",
+        "../../tsconfig.json"
+      ],
+      "output": [
+        "lib/**",
+        "*.tsbuildinfo"
+      ],
+      "clean": "if-file-deleted"
+    },
+    "format": {
+      "command": "prettier --write \"+(src|test)/**/*.+(ts|js|json)\"",
+      "files": [
+        "src/**/*.ts",
+        "test/**/*.ts",
+        ".prettier*"
+      ],
+      "output": []
+    },
+    "lint": {
+      "command": "eslint src test --color --cache --cache-location .eslintcache",
+      "files": [
+        "src/**/*.ts",
+        "test/**/*.ts",
+        "**/.eslint*",
+        "**/tsconfig.json",
+        "../../eslint.config.mjs",
+        "../../tsconfig.json"
+      ],
+      "output": []
+    },
+    "test": {
+      "dependencies": [
+        "test:compile",
+        "test:only",
+        "lint"
+      ]
+    },
+    "test:compile": {
+      "command": "tsc -p \"./test\" --pretty",
+      "files": [
+        "test/**/*.ts",
+        "**/tsconfig.json",
+        "../../tsconfig.json"
+      ],
+      "output": []
+    },
+    "test:only": {
+      "command": "vitest run --project simply-community-core",
+      "env": {
+        "FORCE_COLOR": "2"
+      },
+      "files": [
+        "test/**/*.ts",
+        "src/**/*.ts",
+        "**/tsconfig.json",
+        "../../tsconfig.json",
+        "vitest.config.ts"
+      ],
+      "output": []
+    }
+  },
+  "scripts": {
+    "build": "wireit",
+    "compile": "wireit",
+    "fix-license": "eslint src test --fix --rule \"header/header: [2]\"",
+    "format": "wireit",
+    "lint": "wireit",
+    "test": "wireit",
+    "test:coverage": "vitest run --coverage --project simply-community-core",
+    "test:only": "wireit",
+    "test:watch": "vitest watch --project simply-community-core"
+  }
+}