seedCanonical
Live-backend transport wrapper around the canonical seed — the entry the HARNESS-02 CLI's seed
subcommand and the e2e global-setups (HARNESS-07/08) dispatch to. A registered seed mutation does
not exist on the deployment (fixtures must not ship in the production bundle), so the live runner
(seed/live.ts) re-expresses over the wire: the deployed server-tier
seam for the shop phase, schema-validated CLI imports for the CMS phase, both behind the same
byDomain idempotency key.
Requires CONVEX_SERVER_SECRET (the deployment's server-tier secret) plus, for a FRESH deployment
only, a CLI credential (CONVEX_SELF_HOSTED_ADMIN_KEY or CONVEX_DEPLOY_KEY).
Signature
function seedCanonical(url: string, opts: CanonicalShopFixtureOptions): Promise<string>;Parameters
| Name | Type | Description |
|---|---|---|
url | string | |
opts | CanonicalShopFixtureOptions |
Returns
The canonical shop id as a plain string (the wire boundary erases the branded Id<'shops'>).
Throws
seed/live.ts's seedCanonicalLive.Related
runCli DaemonOptions runDaemon SeedClerkOperatorOptions SeedCmsOptions SeedCanonicalOptions SeedClerkOperatorView SeedShopOptions
SeedCanonicalOptions
Customization knobs for the canonical seed. Identical to the shop seed's options — the CMS phase has no knobs of its own (its documents key off the shop id the
seedClerkOperatorLive
Provisions the e2e Clerk operator's identity model onto a RUNNING deployment by calling the deployed db/clerkseed:seedClerkOperator servertier mutation — the Cl