Skip to content

docs(repo): safeguard against supply chain attacks#2382

Merged
mandarini merged 2 commits into
masterfrom
docs/safeguard-npm
May 21, 2026
Merged

docs(repo): safeguard against supply chain attacks#2382
mandarini merged 2 commits into
masterfrom
docs/safeguard-npm

Conversation

@mandarini

Copy link
Copy Markdown
Contributor

Add user guide on how users can safeguard against npm supply chain attacks

@mandarini mandarini requested a review from a team as a code owner May 19, 2026 14:20
@mandarini mandarini self-assigned this May 19, 2026
@mandarini mandarini force-pushed the docs/safeguard-npm branch from e8636d4 to 4e0e86a Compare May 19, 2026 14:22
staaldraad
staaldraad previously approved these changes May 20, 2026
Comment thread docs/NPM_PACKAGE_SECURITY.md Outdated
Comment thread docs/NPM_PACKAGE_SECURITY.md
Comment thread docs/NPM_PACKAGE_SECURITY.md
Comment thread docs/NPM_PACKAGE_SECURITY.md
Comment thread docs/NPM_PACKAGE_SECURITY.md
@mandarini mandarini merged commit 9623b01 into master May 21, 2026
5 checks passed
@mandarini mandarini deleted the docs/safeguard-npm branch May 21, 2026 11:53

### Deno / Edge Functions

Deno has an unstable `--minimum-dependency-age` flag that accepts minutes, an ISO-8601 duration, or an absolute RFC3339 cutoff:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This wouldn't work with Edge Functions and also an unstable feature. Maybe we should leave this out?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok, I'll put in a follow up to remove. We do acknowledge at least that it's unstable 😓

mandarini added a commit to supabase/supabase that referenced this pull request May 26, 2026
#46384)

Adds a consumer-side guide for hardening npm installs of @supabase/*
packages: lockfile hygiene, minimum-release-age quarantine across
pnpm/yarn/npm/bun, private registries, provenance verification,
lifecycle script controls, blocking exotic transitive refs, Edge
Functions specifics, and an incident-response checklist.
  
Lives at guides/security/ alongside platform-security and
product-security; filesystem-driven sidebar picks it up automatically.

Originally drafted in supabase/supabase-js#2382 and moved here per
review.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Documentation**
* Added an npm security hardening guide (lockfile & CI practices,
release-age quarantines, transitive/exotic dependency controls,
provenance verification, lifecycle-script hardening, package-manager
pinning, CI/lockfile hygiene, Deno/Edge guidance, incident-response
checklist).
  * Added a navigation entry for the new guide.
  * Note: guide frontmatter contains unresolved merge-conflict markers.
* **Chores**
* Expanded spelling allowlist to include common tech terms (e.g.,
lockfile, sigstore, postinstall).

<!-- review_stack_entry_start -->

[![Review Change
Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/supabase/supabase/pull/46384?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack)

<!-- review_stack_entry_end -->
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants