Clerk package parity#59
Draft
zdburrage wants to merge 1 commit into
Draft
Conversation
Phase 13 of the provider-parity plan. Adds package mode to the Clerk transformer alongside the existing single-CSV path. - New \`src/transformers/clerk/package-exporter.ts\` reads the Clerk dashboard CSV plus optional org and role mapping files and emits the canonical package layout: \`users.csv\`, \`organizations.csv\`, \`organization_memberships.csv\`, \`role_definitions.csv\`, \`user_role_assignments.csv\`, \`workos_upload/\`, manifest, warnings, and skipped-user sidecars. - Package and upload-compatible files use the same Clerk \`id\` and \`org_external_id\` so \`import-package\` can resolve users/orgs from either projection. - Unsupported password hashers (anything other than bcrypt) are recorded as structured \`unsupported_password_hasher\` warnings so the package import does not lose users to algorithm mismatch. - \`transform-clerk\` CLI gains \`--package\` and \`--output-dir\` flags. Existing \`--output\` flow is unchanged. - Tests cover: org/role mapping merge, unsupported hasher warning, no-email skip, manifest validation, and the no-mapping baseline. - README leads with the package flow and points at \`import-package\` for next steps.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Phase 13 of the provider-parity execution plan. Clerk transformer now writes a migration package alongside the legacy single-CSV path.
src/transformers/clerk/package-exporter.tsreads the Clerk dashboard CSV plus optional org and role mapping files and emits the canonical layout:users.csv,organizations.csv,organization_memberships.csv,role_definitions.csv,user_role_assignments.csv,workos_upload/, manifest, warnings, skipped-user sidecars.idandorg_external_idsoimport-packageresolves users/orgs from either projection.unsupported_password_hasherwarnings rather than dropping users.transform-clerkCLI gains--packageand--output-dir. Existing--outputflow is unchanged.import-packagefor the next step.Test Plan
npm run lintnpm run format:checknpm run typechecknpm run buildnpm test— 271 passing across 24 suites.🤖 Generated with Claude Code