Skip to content

feat: add PLG preonboarding and delivery config backfill scripts#1976

Open
Kanishkavijay39 wants to merge 19 commits intomainfrom
plg-preonboarding-scripts
Open

feat: add PLG preonboarding and delivery config backfill scripts#1976
Kanishkavijay39 wants to merge 19 commits intomainfrom
plg-preonboarding-scripts

Conversation

@Kanishkavijay39
Copy link
Copy Markdown
Contributor

  • plg-preonboard.js: preonboards domains by creating org/site, enabling audits and summit-plg, creating ASO entitlement, and setting status to PRE_ONBOARDING so the customer's POST /plg/onboard fast-tracks to ONBOARDED. Resolves canonical URL before RUM lookup to handle www redirects.

  • plg-backfill-delivery-config.js: targeted script to backfill deliveryConfig (authorURL, programId, environmentId) for already-preonboarded sites where the initial RUM lookup failed. Uses overrideBaseURL hostname for the RUM query.

Please ensure your pull request adheres to the following guidelines:

  • make sure to link the related issues in this description. Or if there's no issue created, make sure you
    describe here the problem you're solving.
  • when merging / squashing, make sure the fixed issue references are visible in the commits, for easy compilation of release notes

If the PR is changing the API specification:

  • make sure you add a "Not implemented yet" note the endpoint description, if the implementation is not ready
    yet. Ideally, return a 501 status code with a message explaining the feature is not implemented yet.
  • make sure you add at least one example of the request and response.

If the PR is changing the API implementation or an entity exposed through the API:

  • make sure you update the API specification and the examples to reflect the changes.

If the PR is introducing a new audit type:

  • make sure you update the API specification with the type, schema of the audit result and an example

Related Issues

Thanks for contributing!

- plg-preonboard.js: preonboards domains by creating org/site, enabling
  audits and summit-plg, creating ASO entitlement, and setting status
  to PRE_ONBOARDING so the customer's POST /plg/onboard fast-tracks to ONBOARDED.
  Resolves canonical URL before RUM lookup to handle www redirects.

- plg-backfill-delivery-config.js: targeted script to backfill deliveryConfig
  (authorURL, programId, environmentId) for already-preonboarded sites where
  the initial RUM lookup failed. Uses overrideBaseURL hostname for the RUM query.
@codecov
Copy link
Copy Markdown

codecov Bot commented Mar 17, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@github-actions
Copy link
Copy Markdown

This PR will trigger a minor release when merged.

@Kanishkavijay39 Kanishkavijay39 changed the title [TEMP]feat: add PLG preonboarding and delivery config backfill scripts feat: add PLG preonboarding and delivery config backfill scripts Mar 17, 2026
Kanishka and others added 14 commits March 19, 2026 21:50
… admin bypass

- preonboard script: enable all 11 ASO PLG handlers (auto-fix, auto-suggest)
  via single API call, add site entitlement enrollment, trigger audits via SQS,
  use demo org for site/entitlement while keeping customer imsOrgId in record,
  include waitlisted/skipped domains in CSV report
- rollback script: disable all config handlers in one API call
- profiles.json: add auto-fix/auto-suggest handlers to aso_plg profile
- plg-onboarding controller: enable all config handlers in one save call,
  allow admin/API key callers to bypass tenant check in getStatus
- tests: add AccessControlUtil mock and admin bypass test cases for getStatus
Checks preonboarded/onboarded sites for missing data and fills gaps
without overwriting existing values. Backfills: overrideBaseURL,
deliveryConfig (authorURL), code config, hlxConfig, locale, projectId.
Outputs a CSV report with the original site object before any changes,
enabling rollback if needed. Matches the pattern from plg-preonboard.js.
For existing sites, resolve field values but only write when absent.
When present, validate against resolved values and report in CSV as
absent_added, correct, or wrong:actual=X|expected=Y.

New CSV columns: v_deliveryType, v_overrideBaseURL, v_authorURL,
v_code, v_hlxConfig.
Add helper scripts for PLG preonboarding operations:
- add-aso-entitlement, delete-plg-record, set-plg-preonboarding
- plg-enable-handlers, plg-trigger-audits, plg-pageviews
- update-plg-imsorgid, update-plg-orgid, update-site-org
- site-opportunities-report
Documents all 14 scripts with usage, env vars, input formats,
and troubleshooting. Covers the typical workflow from preonboarding
through backfill and rollback.
…mmit

Step 9 (trigger audit runs via SQS for alt-text, cwv, broken-backlinks,
scrape-top-pages) was accidentally removed during the validation columns
refactor. Restored as Step 8.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant