@parity/product-sdk 0.22.0 → 0.23.0

package/src/individuality/contract.test.ts

@@ -10,7 +10,16 @@
  * it by construction.
  *
  * This file closes that gap: if a descriptor regeneration changes a key or a
- * value type, `pnpm typecheck` fails here.
+ * value type, `pnpm typecheck` fails here. It guards both of that package's
+ * chain contracts, `IndividualityChain` for the personhood batch and
+ * `ConsumersChain` for the account to username read.
+ *
+ * **It checks the built `dist`, not the sibling's `src`.** The contracts resolve
+ * through `@parity/product-sdk-individuality`'s `types` field, so editing a
+ * contract and running this typecheck without rebuilding that package asserts
+ * against the previous build. Run `pnpm -r build` first, or the guard silently
+ * checks stale types. Verified 2026-08-19 by mutating a contract and watching
+ * the typecheck pass until the sibling was rebuilt.
  *
  * **It lives in the umbrella package deliberately.** Inside the individuality
  * package the same assertion is vacuous, passing even against a contract that
@@ -22,7 +31,23 @@
  * `@ts-expect-error` would report as unused and this file would fail.
  */
 import type { getChainAPI } from "@parity/product-sdk-chain-client";
-import type { IndividualityChain } from "@parity/product-sdk-individuality";
+import type {
+    RingVRFProof as HostRingVRFProof,
+    VrfSignature as HostVrfSignature,
+    VrfTranscriptItem as HostVrfTranscriptItem,
+} from "@parity/product-sdk-host";
+import type {
+    AirdropChain,
+    ClaimChain,
+    ConsumersChain,
+    GameChain,
+    IndividualityChain,
+    PrizeStatusChain,
+    SignUpChain,
+    AccountVrfSignature,
+    VrfTranscriptItem as IndividualityVrfTranscriptItem,
+    RingVRFProof as AsPersonRingVRFProof,
+} from "@parity/product-sdk-individuality";
 import { expect, test } from "vitest";
 
 // The false branch must be `false`, not `never`. `never` is assignable to
@@ -37,6 +62,29 @@ type DevnetClient = Awaited<ReturnType<typeof getChainAPI<"devnet">>>;
 type PaseoSatisfiesContract = Assert<PaseoClient extends IndividualityChain ? true : false>;
 type DevnetSatisfiesContract = Assert<DevnetClient extends IndividualityChain ? true : false>;
 
+// `ConsumersChain` needs this more than the batch contract does: its value shape
+// was derived from the pallet and the codegen rather than read off the emitted
+// descriptor, so these two lines are what make that derivation a checked fact.
+type PaseoSatisfiesConsumers = Assert<PaseoClient extends ConsumersChain ? true : false>;
+type DevnetSatisfiesConsumers = Assert<DevnetClient extends ConsumersChain ? true : false>;
+
+// Separate from the personhood contract: reading draws needs neither `Resources`
+// nor `PeopleLite`. Both chains satisfy it, which is weaker than it looks — devnet's
+// event-id base is 28 bytes to paseo's 27, and `SizedHex<N>` erases `N`, so only the
+// length check in `airdrop-ids.ts` catches that.
+type PaseoSatisfiesAirdropContract = Assert<PaseoClient extends AirdropChain ? true : false>;
+type DevnetSatisfiesAirdropContract = Assert<DevnetClient extends AirdropChain ? true : false>;
+
+// Same again for the current-game contract, which shares no entry with either of
+// the other two — but paseo only, and that asymmetry is the point.
+type PaseoSatisfiesGameContract = Assert<PaseoClient extends GameChain ? true : false>;
+
+// Devnet's metadata predates the multi-airdrop game work — the 28-byte base above is
+// one symptom, `game-types.ts` lists the rest — so the game surface is paseo-only.
+// Asserted negatively on purpose: a devnet re-pin breaks this line, which is the
+// prompt to flip it positive and check the read against it.
+type DevnetPredatesTheGameContract = Assert<DevnetClient extends GameChain ? false : true>;
+
 // Negative control, kept type-only so it emits no runtime code. If
 // `IndividualityChain` ever stopped constraining, this flips to `false` and the
 // file fails to typecheck, which is what keeps the assertions above honest.
@@ -48,6 +96,228 @@ type ClientWithoutIndividuality = {
 type RejectsBogusClient = Assert<
     ClientWithoutIndividuality extends IndividualityChain ? false : true
 >;
+type RejectsBogusAirdropClient = Assert<
+    ClientWithoutIndividuality extends AirdropChain ? false : true
+>;
+type RejectsBogusGameClient = Assert<ClientWithoutIndividuality extends GameChain ? false : true>;
+
+// `Game.Game` being optional is what makes "between games" representable at all,
+// and `GameIndex` / `GameSchedules` being `ValueQuery` is what lets the read treat
+// them as always answering. The structural contract pins the latter two by typing
+// them non-optional; this pins the first, which no assignability check would
+// catch — a suddenly-required `Game` would still satisfy an optional contract.
+type GameStorage = PaseoClient["individuality"]["query"]["Game"];
+type GameValue = Awaited<ReturnType<GameStorage["Game"]["getValue"]>>;
+type GameIsOptional = Assert<undefined extends GameValue ? true : false>;
+// Negative control: `GameIndex` is `ValueQuery`, so it must *not* admit undefined.
+type GameIndexValue = Awaited<ReturnType<GameStorage["GameIndex"]["getValue"]>>;
+type GameIndexIsNotOptional = Assert<undefined extends GameIndexValue ? false : true>;
+
+// The event id is derived from a runtime constant rather than a storage entry, so
+// the constant has to exist and still be a plain string. Its *width* cannot be
+// asserted here: PAPI's `SizedHex<N>` is `string & { __hexString?: N | unknown }`,
+// and the `| unknown` collapses every width to the same type, so `SizedHex<32>`
+// and `SizedHex<27>` are mutually assignable and any such assertion would pass
+// vacuously. The 27-byte expectation is enforced at runtime instead, by the
+// length check in `airdrop-ids.ts` and the pinned vectors beside it.
+type GameConstants = PaseoClient["individuality"]["constants"]["Game"];
+type EventIdBaseExists = Assert<"airdrop_event_id_base" extends keyof GameConstants ? true : false>;
+type AirdropEventIdBase = Awaited<ReturnType<GameConstants["airdrop_event_id_base"]>>;
+type EventIdBaseIsAString = Assert<AirdropEventIdBase extends string ? true : false>;
+
+// The composed prize-status read spans both pallets, so it is the intersection
+// that has to hold — and on paseo only, since it inherits `GameChain`.
+type PaseoSatisfiesPrizeStatusContract = Assert<
+    PaseoClient extends PrizeStatusChain ? true : false
+>;
+type DevnetPredatesThePrizeStatusContract = Assert<
+    DevnetClient extends PrizeStatusChain ? false : true
+>;
+
+// `Registrations` is keyed by the entropy slot with the entry as its *value*, so
+// `readDrawRegistration` can only work by scanning the event's prefix. Pinning the
+// arity here is what would catch a descriptor regeneration that added a reverse
+// index and made the scan unnecessary.
+type RegistrationsEntries = Awaited<
+    ReturnType<PaseoClient["individuality"]["query"]["Airdrop"]["Registrations"]["getEntries"]>
+>;
+type RegistrationsKeyIsEventIdAndSlot = Assert<
+    RegistrationsEntries[number]["keyArgs"] extends [unknown, unknown] ? true : false
+>;
+
+// `Winners` is a double map keyed by the registration entry, which is what makes
+// "did I win" a point lookup instead of a scan of every winner. If a descriptor
+// regeneration ever collapsed it to a single key, the read layer would silently
+// need rewriting, so the arity is pinned.
+type WinnersKey = Parameters<
+    PaseoClient["individuality"]["query"]["Airdrop"]["Winners"]["getValue"]
+>;
+type WinnersTakesTwoKeys = Assert<
+    WinnersKey extends [unknown, unknown, ...unknown[]] ? true : false
+>;
+
+type RejectsBogusConsumersClient = Assert<
+    ClientWithoutIndividuality extends ConsumersChain ? false : true
+>;
+
+// The write half declares its own `RingVRFProof` rather than importing the
+// host's, for the same reason `IndividualityChain` is structural: it keeps the
+// individuality package free of a dependency on `@parity/product-sdk-host`. The
+// cost is that a field rename on the host side would go unnoticed there, since
+// nothing in that package resolves the host type. Here both are direct
+// dependencies, so this is where the two can be tied together.
+type HostProofSatisfiesLocal = Assert<HostRingVRFProof extends AsPersonRingVRFProof ? true : false>;
+
+// Negative control for the same assertion. If `AsPersonRingVRFProof` ever
+// stopped constraining, this flips to `false` and the file fails to typecheck.
+type ProofWithoutRingIndex = {
+    proof: Uint8Array;
+    contextualAlias: { context: Uint8Array; alias: Uint8Array };
+    ringRevision: number;
+};
+type RejectsProofMissingRingIndex = Assert<
+    ProofWithoutRingIndex extends AsPersonRingVRFProof ? false : true
+>;
+
+// `AliasWithProof` is only ever accepted for `People.set_alias_account`, so the
+// call has to exist on the real chain with the two arguments the extension's
+// validation reads. A descriptor regeneration that renames either fails here.
+type PeopleTx = PaseoClient["individuality"]["tx"]["People"];
+type SetAliasAccountExists = Assert<"set_alias_account" extends keyof PeopleTx ? true : false>;
+type SetAliasAccountArgs = Parameters<PeopleTx["set_alias_account"]>[0];
+type SetAliasAccountTakesAccountAndValidAt = Assert<
+    "account" extends keyof SetAliasAccountArgs
+        ? "call_valid_at" extends keyof SetAliasAccountArgs
+            ? true
+            : false
+        : false
+>;
+
+// The JSDoc examples in the individuality package submit
+// `Game.sign_up_with_alias` under a person origin. A person origin supplies only
+// the origin, never the call arguments, so those snippets go stale the moment
+// this call's parameters change — and nothing else in the repo compiles them.
+type GameTx = PaseoClient["individuality"]["tx"]["Game"];
+type SignUpWithAliasExists = Assert<"sign_up_with_alias" extends keyof GameTx ? true : false>;
+type SignUpWithAliasArgs = Parameters<GameTx["sign_up_with_alias"]>[0];
+type SignUpWithAliasTakesTheDocumentedArgs = Assert<
+    "identifier_key" extends keyof SignUpWithAliasArgs
+        ? "statement_account" extends keyof SignUpWithAliasArgs
+            ? "sig" extends keyof SignUpWithAliasArgs
+                ? true
+                : false
+            : false
+        : false
+>;
+
+// Negative control for the assertion above. The `extends keyof` chain would pass
+// vacuously if `SignUpWithAliasArgs` ever resolved to something permissive such
+// as `any`, so this pins a shape that is missing `sig` and requires it to fail.
+type SignUpArgsWithoutSig = Pick<SignUpWithAliasArgs, "identifier_key" | "statement_account">;
+type RejectsSignUpArgsMissingSig = Assert<"sig" extends keyof SignUpArgsWithoutSig ? false : true>;
+
+// The claim is the one contract here that touches `tx` as well as storage. Paseo
+// only, like the game surface it composes with.
+type PaseoSatisfiesClaimContract = Assert<PaseoClient extends ClaimChain ? true : false>;
+type RejectsBogusClaimClient = Assert<ClientWithoutIndividuality extends ClaimChain ? false : true>;
+
+// `claim_airdrop`'s three arguments, pinned by name. `ClaimChain` types them
+// structurally, and PAPI encodes whatever object it is handed — so a renamed field
+// would encode as `undefined` and fail on chain with nothing local to point at it.
+type ClaimAirdropArgs = Parameters<GameTx["claim_airdrop"]>[0];
+type ClaimAirdropTakesTheDocumentedArgs = Assert<
+    "game_index" extends keyof ClaimAirdropArgs
+        ? "airdrop_index" extends keyof ClaimAirdropArgs
+            ? "beneficiary" extends keyof ClaimAirdropArgs
+                ? true
+                : false
+            : false
+        : false
+>;
+
+// Game sign-up.
+type PaseoSatisfiesSignUpContract = Assert<PaseoClient extends SignUpChain ? true : false>;
+type RejectsBogusSignUpClient = Assert<
+    ClientWithoutIndividuality extends SignUpChain ? false : true
+>;
+
+// `SignUpChain` alone does not reject devnet and cannot: a `tx` argument is
+// checked contravariantly and excess-property checking does not apply between
+// named types, so an interface naming `airdrops` is satisfied by devnet's call,
+// which has only `airdrop`. `identifier_key` does not separate them either, since
+// `SizedHex<N>`'s brand is optional. Assert on the intersection the read takes,
+// where `GameChain` is the half that rejects devnet.
+type PaseoSatisfiesSignUpRead = Assert<PaseoClient extends GameChain & SignUpChain ? true : false>;
+type DevnetPredatesTheSignUpRead = Assert<
+    DevnetClient extends GameChain & SignUpChain ? false : true
+>;
+
+// The divergence itself: devnet's argument is `airdrop`, so `signUpWithAccountTx`
+// emitting `airdrops` would encode as `undefined` and enter no draw at all.
+type DevnetGameTx = DevnetClient["individuality"]["tx"]["Game"];
+type DevnetSignUpArgs = Parameters<DevnetGameTx["sign_up_with_account"]>[0];
+type DevnetHasNoAirdropsArg = Assert<"airdrops" extends keyof DevnetSignUpArgs ? false : true>;
+type DevnetHasTheSingularArg = Assert<"airdrop" extends keyof DevnetSignUpArgs ? true : false>;
+
+// Pinned by name for the same reason `claim_airdrop`'s are: PAPI encodes the
+// object it is handed, so a renamed field silently encodes as `undefined`.
+type SignUpWithAccountArgs = Parameters<GameTx["sign_up_with_account"]>[0];
+type SignUpWithAccountTakesTheDocumentedArgs = Assert<
+    "identifier_key" extends keyof SignUpWithAccountArgs
+        ? "airdrops" extends keyof SignUpWithAccountArgs
+            ? true
+            : false
+        : false
+>;
+
+// `None` is how a player enters no draw, and the only form a recognized player
+// can use at all.
+type AirdropsArg = SignUpWithAccountArgs["airdrops"];
+type AirdropsIsOptional = Assert<undefined extends AirdropsArg ? true : false>;
+
+// Extracted from the enum rather than restated, so a renamed field fails here
+// instead of on chain.
+type AccountVrfs = Extract<NonNullable<AirdropsArg>, { type: "Account" }>["value"][number];
+type AccountVrfHasPreOutputAndProof = Assert<
+    "pre_output" extends keyof AccountVrfs
+        ? "proof" extends keyof AccountVrfs
+            ? true
+            : false
+        : false
+>;
+
+// The VRF types are local copies of the host's, declared here for the same reason
+// `AsPersonRingVRFProof` is: so the package keeps no host dependency. Those host
+// types are mapped straight off truapi's wire types, so a rename there changes them
+// with no line of this repo touched, and the break would land as a runtime
+// TypeError rather than a failed typecheck.
+type HostVrfSignatureSatisfiesLocal = Assert<
+    HostVrfSignature extends AccountVrfSignature ? true : false
+>;
+type HostVrfItemSatisfiesLocal = Assert<
+    HostVrfTranscriptItem extends IndividualityVrfTranscriptItem ? true : false
+>;
+
+// Negative controls, so the two above cannot pass vacuously.
+type RejectsSignatureMissingProof = Assert<
+    { preOutput: Uint8Array } extends AccountVrfSignature ? false : true
+>;
+type RejectsItemMissingValue = Assert<
+    { label: Uint8Array } extends IndividualityVrfTranscriptItem ? false : true
+>;
+
+// `Game.Players`: the variant spelling the read keys by, and the one field it uses.
+// Sibling reads got exactly these pins.
+type PlayersEntry = PaseoClient["individuality"]["query"]["Game"]["Players"];
+type PlayersKey = Parameters<PlayersEntry["getValue"]>[0];
+type PlayersKeyIsAccountOrPerson = Assert<
+    PlayersKey extends { type: "Account" | "Person" } ? true : false
+>;
+type RejectsAliasSpelling = Assert<
+    { type: "Alias"; value: string } extends PlayersKey ? false : true
+>;
+type PlayersValue = NonNullable<Awaited<ReturnType<PlayersEntry["getValue"]>>>;
+type PlayersHasRegistered = Assert<"registered" extends keyof PlayersValue ? true : false>;
 
 test("the individuality chain contract is asserted at compile time", () => {
     // The type assertions above are the test. This keeps vitest from reporting

package/dist/chunk-6BI66XUJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/createApp.ts"],"names":["err"],"mappings":";;;;;;;;;AAyCA,IAAM,GAAA,GAAM,aAAa,KAAK,CAAA;AA0C9B,eAAsB,UAAU,MAAA,EAAiC;AAE7D,EAAA,IAAI,OAAO,QAAA,EAAU;AACjB,IAAA,SAAA,CAAU,EAAE,KAAA,EAAO,MAAA,CAAO,QAAA,EAAU,CAAA;AAAA,EACxC;AAEA,EAAA,GAAA,CAAI,KAAK,0BAAA,EAA4B,EAAE,IAAA,EAAM,MAAA,CAAO,MAAM,CAAA;AAG1D,EAAA,MAAM,eAAe,MAAM,kBAAA,CAAmB,EAAE,MAAA,EAAQ,MAAA,CAAO,MAAM,CAAA;AAGrE,EAAA,MAAM,aAAA,GAAgB,IAAI,aAAA,CAAc;AAAA,IACpC,UAAU,MAAA,CAAO;AAAA,GACpB,CAAA;AAUD,EAAA,MAAM,mBAAA,GAAsB,OAAO,YAAA,KAAiB,KAAA;AACpD,EAAA,MAAM,0BACF,OAAO,MAAA,CAAO,iBAAiB,QAAA,GAAW,MAAA,CAAO,aAAa,WAAA,GAAc,OAAA;AAChF,EAAA,MAAM,kBAAA,GAAqB,mBAAA,GACrB,MAAM,kBAAA,CAAmB,MAAA,CAAO;AAAA,IAC5B,WAAA,EAAa,uBAAA;AAAA,IACb,MAAA,EAAQ,gBAAA,CAAiB,MAAM,aAAA,CAAc,WAAW;AAAA,GAC3D,CAAA,GACD,IAAA;AAEN,EAAA,IAAI,mBAAA,EAAqB;AACrB,IAAA,GAAA,CAAI,MAAM,6CAAA,EAA+C;AAAA,MACrD,WAAA,EAAa;AAAA,KAChB,CAAA;AAAA,EACL,CAAA,MAAO;AACH,IAAA,GAAA,CAAI,MAAM,+BAA+B,CAAA;AAAA,EAC7C;AAGA,EAAA,MAAM,eAAA,GAAmC;AAAA,IACrC,GAAA,EAAK,CAAC,GAAA,KAAQ,YAAA,CAAa,IAAI,GAAG,CAAA;AAAA,IAClC,KAAK,CAAC,GAAA,EAAK,UAAU,YAAA,CAAa,GAAA,CAAI,KAAK,KAAK,CAAA;AAAA,IAChD,OAAA,EAAS,CAAI,GAAA,KAAgB,YAAA,CAAa,QAAW,GAAG,CAAA;AAAA,IACxD,SAAS,CAAI,GAAA,EAAa,UAAa,YAAA,CAAa,OAAA,CAAQ,KAAK,KAAK,CAAA;AAAA,IACtE,MAAA,EAAQ,CAAC,GAAA,KAAQ,YAAA,CAAa,OAAO,GAAG,CAAA;AAAA,IACxC,OAAO,YAAY;AAEf,MAAA,GAAA,CAAI,MAAM,oDAAoD,CAAA;AAAA,IAClE;AAAA,GACJ;AAGA,EAAA,MAAM,SAAA,GAAY,gBAAgB,aAAa,CAAA;AAG/C,EAAA,MAAM,QAAA,GAAqB;AAAA,IACvB,UAAU,UAAA,EAAY;AAClB,MAAA,GAAA,CAAI,MAAM,kBAAA,EAAoB,EAAE,OAAA,EAAS,UAAA,CAAW,SAAS,CAAA;AAC7D,MAAA,MAAM,MAAA,GAAS,UAAU,UAAU,CAAA;AACnC,MAAA,OAAO,MAAA,CAAO,YAAY,UAAU,CAAA;AAAA,IACxC,CAAA;AAAA,IAEA,aAAa,UAAA,EAAY;AACrB,MAAA,GAAA,CAAI,MAAM,qBAAA,EAAuB,EAAE,OAAA,EAAS,UAAA,CAAW,SAAS,CAAA;AAChE,MAAA,OAAO,UAAU,UAAU,CAAA;AAAA,IAC/B,CAAA;AAAA,IAEA,MAAM,QAAmD,MAAA,EAAW;AAChE,MAAA,GAAA,CAAI,KAAA,CAAM,kBAAkB,EAAE,MAAA,EAAQ,OAAO,IAAA,CAAK,MAAM,GAAG,CAAA;AAC3D,MAAA,OAAO,iBAAA,CAAkB,EAAE,MAAA,EAAQ,CAAA;AAAA,IACvC,CAAA;AAAA,IAEA,YAAY,UAAA,EAAY;AACpB,MAAA,OAAO,YAAY,UAAU,CAAA;AAAA,IACjC,CAAA;AAAA,IAEA,UAAA,GAAa;AACT,MAAA,GAAA,CAAI,MAAM,mBAAmB,CAAA;AAC7B,MAAA,UAAA,EAAW;AAAA,IACf;AAAA,GACJ;AAGA,EAAA,MAAM,kBAA0C,kBAAA,GAC1C;AAAA,IACI,MAAA,EAAQ,OAAO,IAAA,KAAS;AACpB,MAAA,MAAM,KAAA,GAAQ,OAAO,IAAA,KAAS,QAAA,GAAW,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,IAAI,CAAA,GAAI,IAAA;AAC1E,MAAA,IAAI;AAMA,QAAA,MAAM,QAAA,GAAW,MAAM,kBAAA,CAClB,KAAA,CAAM,KAAK,CAAA,CACX,YAAA,CAAa,IAAI,CAAA,CACjB,IAAA,EAAK;AACV,QAAA,IAAI,CAAC,SAAS,GAAA,EAAK;AACf,UAAA,OAAO,GAAA;AAAA,YACH,IAAI,wBAAA;AAAA,cACA;AAAA;AACJ,WACJ;AAAA,QACJ;AACA,QAAA,OAAO,EAAA,CAAG,QAAA,CAAS,GAAA,CAAI,QAAA,EAAU,CAAA;AAAA,MACrC,SAAS,KAAA,EAAO;AACZ,QAAA,MAAM,UAAU,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AACrE,QAAA,OAAO,IAAI,IAAI,wBAAA,CAAyB,SAAS,EAAE,KAAA,EAAO,CAAC,CAAA;AAAA,MAC/D;AAAA,IACJ,CAAA;AAAA,IACA,KAAA,EAAO,CAAC,GAAA,KAAQ,kBAAA,CAAmB,WAAW,GAAG,CAAA;AAAA,IACjD,UAAA,EAAY,OAAO,IAAA,KAAS;AACxB,MAAA,MAAM,KAAA,GAAQ,OAAO,IAAA,KAAS,QAAA,GAAW,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,IAAI,CAAA,GAAI,IAAA;AAC1E,MAAA,MAAM,GAAA,GAAM,MAAM,YAAA,CAAa,KAAK,CAAA;AACpC,MAAA,OAAO,IAAI,QAAA,EAAS;AAAA,IACxB;AAAA,GACJ,GACA,IAAA;AAEN,EAAA,GAAA,CAAI,KAAK,yBAAA,EAA2B;AAAA,IAChC,MAAM,MAAA,CAAO,IAAA;AAAA,IACb,YAAA,EAAc,sBAAsB,uBAAA,GAA0B;AAAA,GACjE,CAAA;AAED,EAAA,OAAO;AAAA,IACH,MAAA,EAAQ,SAAA;AAAA,IACR,YAAA,EAAc,eAAA;AAAA,IACd,KAAA,EAAO,QAAA;AAAA,IACP,YAAA,EAAc,eAAA;AAAA,IACd,UAAA,EAAY,OAAO,EAAE,GAAG,MAAA,EAAO;AAAA,GACnC;AACJ;AAKA,SAAS,gBAAgB,aAAA,EAAyC;AAE9D,EAAA,MAAM,wBAAA,uBAA+B,GAAA,EAAuC;AAG5E,EAAA,aAAA,CAAc,SAAA,CAAU,CAAC,KAAA,KAAU;AAC/B,IAAA,MAAM,OAAA,GAAU,MAAM,eAAA,GAChB;AAAA,MACI,OAAA,EAAS,MAAM,eAAA,CAAgB,OAAA;AAAA,MAC/B,IAAA,EAAM,KAAA,CAAM,eAAA,CAAgB,IAAA,IAAQ,MAAA;AAAA,MACpC,MAAA,EAAQ,MAAM,eAAA,CAAgB;AAAA,KAClC,GACA,IAAA;AACN,IAAA,KAAA,MAAW,YAAY,wBAAA,EAA0B;AAC7C,MAAA,IAAI;AACA,QAAA,QAAA,CAAS,OAAO,CAAA;AAAA,MACpB,SAAS,CAAA,EAAG;AACR,QAAA,GAAA,CAAI,IAAA,CAAK,+BAAA,EAAiC,EAAE,KAAA,EAAO,GAAG,CAAA;AAAA,MAC1D;AAAA,IACJ;AAAA,EACJ,CAAC,CAAA;AAED,EAAA,OAAO;AAAA,IACH,MAAM,OAAA,GAA4C;AAC9C,MAAA,MAAM,MAAA,GAAS,MAAM,aAAA,CAAc,OAAA,EAAQ;AAC3C,MAAA,IAAI,CAAC,OAAO,EAAA,EAAI;AACZ,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,CAAM,OAAO,CAAA;AAAA,MACxC;AACA,MAAA,OAAO;AAAA,QACH,QAAA,EAAU,MAAA,CAAO,KAAA,CAAM,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,UAC/B,SAAS,CAAA,CAAE,OAAA;AAAA,UACX,IAAA,EAAM,EAAE,IAAA,IAAQ,MAAA;AAAA,UAChB,QAAQ,CAAA,CAAE;AAAA,SACd,CAAE;AAAA,OACN;AAAA,IACJ,CAAA;AAAA,IAEA,MAAM,UAAA,GAA4B;AAC9B,MAAA,aAAA,CAAc,UAAA,EAAW;AAAA,IAC7B,CAAA;AAAA,IAEA,WAAA,GAAyB;AACrB,MAAA,OAAO,cAAc,QAAA,EAAS,CAAE,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,QACjD,SAAS,CAAA,CAAE,OAAA;AAAA,QACX,IAAA,EAAM,EAAE,IAAA,IAAQ,MAAA;AAAA,QAChB,QAAQ,CAAA,CAAE;AAAA,OACd,CAAE,CAAA;AAAA,IACN,CAAA;AAAA,IAEA,kBAAA,GAAqC;AACjC,MAAA,MAAM,QAAA,GAAW,aAAA,CAAc,QAAA,EAAS,CAAE,eAAA;AAC1C,MAAA,IAAI,CAAC,UAAU,OAAO,IAAA;AACtB,MAAA,OAAO;AAAA,QACH,SAAS,QAAA,CAAS,OAAA;AAAA,QAClB,IAAA,EAAM,SAAS,IAAA,IAAQ,MAAA;AAAA,QACvB,QAAQ,QAAA,CAAS;AAAA,OACrB;AAAA,IACJ,CAAA;AAAA,IAEA,cAAc,OAAA,EAAuB;AACjC,MAAA,aAAA,CAAc,cAAc,OAAO,CAAA;AAAA,IACvC,CAAA;AAAA,IAEA,MAAM,YAAY,OAAA,EAAmD;AACjE,MAAA,MAAM,KAAA,GAAQ,OAAO,OAAA,KAAY,QAAA,GAAW,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,OAAO,CAAA,GAAI,OAAA;AAChF,MAAA,MAAM,MAAA,GAAS,MAAM,aAAA,CAAc,OAAA,CAAQ,KAAK,CAAA;AAChD,MAAA,IAAI,CAAC,OAAO,EAAA,EAAI;AACZ,QAAA,MAAM,IAAI,KAAA,CAAM,MAAA,CAAO,KAAA,CAAM,OAAO,CAAA;AAAA,MACxC;AACA,MAAA,OAAO,MAAA,CAAO,KAAA;AAAA,IAClB,CAAA;AAAA,IAEA,MAAM,6BAA6B,IAAA,EAAM;AACrC,MAAA,MAAM,OAAA,GACF,OAAO,IAAA,CAAK,OAAA,KAAY,QAAA,GAClB,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,IAAA,CAAK,OAAO,CAAA,GACrC,IAAA,CAAK,OAAA;AACf,MAAA,MAAM,gBAAA,GAAmB,MAAM,uBAAA,EAAwB;AACvD,MAAA,MAAM,QAAA,GAAW,IAAA,CAAK,QAAA,IAAa,MAAM,mBAAmB,gBAAgB,CAAA;AAS5E,MAAA,MAAM,eAAe,WAAA,CAAY,IAAA,CAAK,WAAW,CAAA,GAC3C,SAAA,CAAU,KAAK,WAAW,CAAA,GAC1B,MAAM,iBAAA,CAAkB,EAAE,QAAQ,EAAE,MAAA,EAAQ,KAAK,WAAA,EAAY,EAAG,CAAA,CAAE,IAAA;AAAA,QAC9D,CAAC,CAAA,KAAM,CAAA,CAAE,GAAA,CAAI;AAAA,OACjB;AAMN,MAAA,MAAM,YAAY,YAAA,CAAa,WAAA;AAAA,QAC3B,IAAA,CAAK;AAAA,OACT;AACA,MAAA,MAAM,SAAA,GAAY,MAAM,0BAAA,CAA2B,QAAA,EAAU,SAAS,CAAA;AACtE,MAAA,IAAI,CAAC,SAAA,EAAW;AACZ,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,gCAAA,EAAmC,QAAQ,CAAA,CAAA,CAAG,CAAA;AAAA,MAClE;AAEA,MAAA,MAAM,KAAA,GAAQ,oBAAoB,SAAS,CAAA;AAC3C,MAAA,MAAM,MAAA,GAAS,iBAAiB,sBAAA,CAAuB;AAAA,QACnD,SAAA,EAAW,KAAA;AAAA,QACX,IAAA,EAAM;AAAA,OACT,CAAA;AAED,MAAA,IAAI;AACA,QAAA,OAAO;AAAA,UACH,QAAA;AAAA,UACA,SAAA;AAAA,UACA,SAAA,EAAW,MAAM,MAAA,CAAO,SAAA,CAAU,OAAO;AAAA,SAC7C;AAAA,MACJ,SAAS,KAAA,EAAO;AACZ,QAAA,MAAM,IAAI,KAAA;AAAA,UACN,CAAA,oCAAA,EAAuC,QAAQ,CAAA,GAAA,EAC3C,KAAA,YAAiB,QAAQ,KAAA,CAAM,OAAA,GAAU,MAAA,CAAO,KAAK,CACzD,CAAA,CAAA;AAAA,UACA,EAAE,KAAA;AAAM,SACZ;AAAA,MACJ;AAAA,IACJ,CAAA;AAAA,IAEA,gBAAgB,QAAA,EAAyD;AACrE,MAAA,wBAAA,CAAyB,IAAI,QAAQ,CAAA;AACrC,MAAA,OAAO,MAAM,wBAAA,CAAyB,MAAA,CAAO,QAAQ,CAAA;AAAA,IACzD,CAAA;AAAA,IAEA,iBAAA,GAAoC;AAGhC,MAAA,GAAA,CAAI,IAAA;AAAA,QACA;AAAA,OACJ;AACA,MAAA,OAAO,IAAA;AAAA,IACX,CAAA;AAAA,IAEA,iBAAA,GAAmC;AAG/B,MAAA,GAAA,CAAI,IAAA;AAAA,QACA;AAAA,OACJ;AACA,MAAA,OAAO,IAAA;AAAA,IACX,CAAA;AAAA,IAEA,MAAM,YAAY,QAAA,EAA2C;AAEzD,MAAA,MAAM,IAAI,KAAA;AAAA,QACN;AAAA,OAEJ;AAAA,IACJ;AAAA,GACJ;AACJ;AAIA,eAAe,uBAAA,GAAyD;AACpE,EAAA,MAAM,QAAA,GAAW,MAAM,mBAAA,EAAoB;AAC3C,EAAA,IAAI,CAAC,QAAA,EAAU;AACX,IAAA,MAAM,IAAI,MAAM,yCAAyC,CAAA;AAAA,EAC7D;AACA,EAAA,OAAO,QAAA;AACX;AAEA,eAAe,mBAAmB,gBAAA,EAAyD;AACvF,EAAA,MAAM,MAAA,GAAS,MAAM,gBAAA,CAAiB,SAAA,EAAU,CAAE,KAAA;AAAA,IAC9C,CAAC,KAAA,KAAU,KAAA;AAAA,IACX,CAACA,IAAAA,KAAQ;AACL,MAAA,MAAMA,IAAAA;AAAA,IACV;AAAA,GACJ;AACA,EAAA,MAAM,QAAA,GAAW,MAAA,CAAO,eAAA,CAAgB,IAAA,EAAK;AAC7C,EAAA,IAAI,CAAC,QAAA,EAAU;AACX,IAAA,MAAM,IAAI,MAAM,wDAAwD,CAAA;AAAA,EAC5E;AACA,EAAA,OAAO,QAAA;AACX","file":"chunk-6BI66XUJ.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * createApp - Main entry point for the Product SDK\n *\n * Creates an App instance with wallet, storage, chain, and cloud storage APIs.\n */\n\nimport type { ChainDefinition } from \"polkadot-api\";\nimport type {\n    App,\n    AppConfig,\n    WalletApi,\n    ChainApi,\n    Account,\n    CloudStorageApi,\n    LocalStorageApi,\n} from \"./types.js\";\nimport { configure, createLogger } from \"@parity/product-sdk-logger\";\nimport { createLocalKvStore } from \"@parity/product-sdk-local-storage\";\nimport { SignerManager } from \"@parity/product-sdk-signer\";\nimport {\n    CloudStorageClient,\n    ProductCloudStorageError,\n    calculateCid,\n    createLazySigner,\n} from \"@parity/product-sdk-cloud-storage\";\nimport { err, ok } from \"@parity/result\";\nimport {\n    createChainClient,\n    getClient,\n    isConnected,\n    destroyAll,\n} from \"@parity/product-sdk-chain-client\";\nimport { getAccountsProvider } from \"@parity/product-sdk-host\";\nimport {\n    accountIdHexToBytes,\n    type PeopleUsernameQueryApi,\n    resolvePeopleUsernameOwner,\n} from \"../identity/dotns.js\";\n\nconst log = createLogger(\"app\");\n\n/**\n * Create a new Product SDK app instance\n *\n * @param config - Application configuration\n * @returns App instance with all APIs\n *\n * @example\n * ```ts\n * import { createApp } from '@parity/product-sdk';\n *\n * // Default: cloud storage enabled with paseo environment\n * const app = await createApp({\n *   name: 'my-app',\n *   logLevel: 'info',\n * });\n *\n * // Custom cloud storage environment\n * const prodApp = await createApp({\n *   name: 'my-app',\n *   cloudStorage: { environment: 'polkadot' },\n * });\n *\n * // Disable cloud storage entirely\n * const noCloudStorageApp = await createApp({\n *   name: 'my-app',\n *   cloudStorage: false,\n * });\n *\n * // Connect wallet\n * const { accounts } = await app.wallet.connect();\n *\n * // Use storage\n * await app.localStorage.set('key', 'value');\n *\n * // Use cloud storage (check for null if it might be disabled)\n * if (app.cloudStorage) {\n *   const cid = await app.cloudStorage.upload('hello world');\n * }\n * ```\n */\nexport async function createApp(config: AppConfig): Promise<App> {\n    // Set log level if specified\n    if (config.logLevel) {\n        configure({ level: config.logLevel });\n    }\n\n    log.info(\"Creating Product SDK app\", { name: config.name });\n\n    // Initialize storage (container-only - will throw if not in container)\n    const localKvStore = await createLocalKvStore({ prefix: config.name });\n\n    // Initialize signer manager\n    const signerManager = new SignerManager({\n        dappName: config.name,\n    });\n\n    // Initialize cloud storage client (configurable, defaults to paseo).\n    //\n    // The signer is wrapped lazily so the cloud storage client can be built before\n    // an account is selected. Uploads will throw a clear error if no signer\n    // is available at submission time. Reads (fetch / fetchJson) don't need\n    // a signer, so they work regardless of whether an account is selected --\n    // but they are container-only and throw CloudStorageHostUnavailableError\n    // outside a host container (no IPFS-gateway fallback).\n    const cloudStorageEnabled = config.cloudStorage !== false;\n    const cloudStorageEnvironment =\n        typeof config.cloudStorage === \"object\" ? config.cloudStorage.environment : \"paseo\";\n    const cloudStorageClient = cloudStorageEnabled\n        ? await CloudStorageClient.create({\n              environment: cloudStorageEnvironment,\n              signer: createLazySigner(() => signerManager.getSigner()),\n          })\n        : null;\n\n    if (cloudStorageEnabled) {\n        log.debug(\"Cloud Storage client (Bulletin) initialized\", {\n            environment: cloudStorageEnvironment,\n        });\n    } else {\n        log.debug(\"Cloud Storage client disabled\");\n    }\n\n    // Create storage API adapter\n    const localStorageApi: LocalStorageApi = {\n        get: (key) => localKvStore.get(key),\n        set: (key, value) => localKvStore.set(key, value),\n        getJSON: <T>(key: string) => localKvStore.getJSON<T>(key),\n        setJSON: <T>(key: string, value: T) => localKvStore.setJSON(key, value),\n        remove: (key) => localKvStore.remove(key),\n        clear: async () => {\n            // LocalKvStore doesn't have clear - this is a no-op\n            log.debug(\"clear() is not supported in container storage mode\");\n        },\n    };\n\n    // Create wallet API adapter\n    const walletApi = createWalletApi(signerManager);\n\n    // Create chain API\n    const chainApi: ChainApi = {\n        getClient(descriptor) {\n            log.debug(\"getClient called\", { genesis: descriptor.genesis });\n            const client = getClient(descriptor);\n            return client.getTypedApi(descriptor);\n        },\n\n        getRawClient(descriptor) {\n            log.debug(\"getRawClient called\", { genesis: descriptor.genesis });\n            return getClient(descriptor);\n        },\n\n        async connect<T extends Record<string, ChainDefinition>>(chains: T) {\n            log.debug(\"connect called\", { chains: Object.keys(chains) });\n            return createChainClient({ chains });\n        },\n\n        isConnected(descriptor) {\n            return isConnected(descriptor);\n        },\n\n        destroyAll() {\n            log.debug(\"destroyAll called\");\n            destroyAll();\n        },\n    };\n\n    // Create Cloud Storage API adapter (null if disabled)\n    const cloudStorageApi: CloudStorageApi | null = cloudStorageClient\n        ? {\n              upload: async (data) => {\n                  const bytes = typeof data === \"string\" ? new TextEncoder().encode(data) : data;\n                  try {\n                      // Explicitly request a DAG-PB manifest so chunked uploads always\n                      // resolve to a single root CID. Without this, AsyncBulletinClient\n                      // can return `result.cid: undefined` for chunked-without-manifest\n                      // uploads — but app consumers expect a CID they can hand to\n                      // `fetch(cid)`, so treat a missing CID as an error.\n                      const uploaded = await cloudStorageClient\n                          .store(bytes)\n                          .withManifest(true)\n                          .send();\n                      if (!uploaded.cid) {\n                          return err(\n                              new ProductCloudStorageError(\n                                  \"Cloud storage upload returned no CID despite .withManifest(true). Upstream contract may have shifted — file an issue.\",\n                              ),\n                          );\n                      }\n                      return ok(uploaded.cid.toString());\n                  } catch (cause) {\n                      const message = cause instanceof Error ? cause.message : String(cause);\n                      return err(new ProductCloudStorageError(message, { cause }));\n                  }\n              },\n              fetch: (cid) => cloudStorageClient.fetchBytes(cid),\n              computeCid: async (data) => {\n                  const bytes = typeof data === \"string\" ? new TextEncoder().encode(data) : data;\n                  const cid = await calculateCid(bytes);\n                  return cid.toString();\n              },\n          }\n        : null;\n\n    log.info(\"Product SDK app created\", {\n        name: config.name,\n        cloudStorage: cloudStorageEnabled ? cloudStorageEnvironment : \"disabled\",\n    });\n\n    return {\n        wallet: walletApi,\n        localStorage: localStorageApi,\n        chain: chainApi,\n        cloudStorage: cloudStorageApi,\n        getAppInfo: () => ({ ...config }),\n    };\n}\n\n/**\n * Create wallet API adapter using SignerManager from leaf package\n */\nfunction createWalletApi(signerManager: SignerManager): WalletApi {\n    // Track account change subscribers\n    const accountChangeSubscribers = new Set<(account: Account | null) => void>();\n\n    // Subscribe to signer manager state changes\n    signerManager.subscribe((state) => {\n        const account = state.selectedAccount\n            ? {\n                  address: state.selectedAccount.address,\n                  name: state.selectedAccount.name ?? undefined,\n                  source: state.selectedAccount.source,\n              }\n            : null;\n        for (const callback of accountChangeSubscribers) {\n            try {\n                callback(account);\n            } catch (e) {\n                log.warn(\"Account change callback threw\", { error: e });\n            }\n        }\n    });\n\n    return {\n        async connect(): Promise<{ accounts: Account[] }> {\n            const result = await signerManager.connect();\n            if (!result.ok) {\n                throw new Error(result.error.message);\n            }\n            return {\n                accounts: result.value.map((a) => ({\n                    address: a.address,\n                    name: a.name ?? undefined,\n                    source: a.source,\n                })),\n            };\n        },\n\n        async disconnect(): Promise<void> {\n            signerManager.disconnect();\n        },\n\n        getAccounts(): Account[] {\n            return signerManager.getState().accounts.map((a) => ({\n                address: a.address,\n                name: a.name ?? undefined,\n                source: a.source,\n            }));\n        },\n\n        getSelectedAccount(): Account | null {\n            const selected = signerManager.getState().selectedAccount;\n            if (!selected) return null;\n            return {\n                address: selected.address,\n                name: selected.name ?? undefined,\n                source: selected.source,\n            };\n        },\n\n        selectAccount(address: string): void {\n            signerManager.selectAccount(address);\n        },\n\n        async signMessage(message: string | Uint8Array): Promise<Uint8Array> {\n            const bytes = typeof message === \"string\" ? new TextEncoder().encode(message) : message;\n            const result = await signerManager.signRaw(bytes);\n            if (!result.ok) {\n                throw new Error(result.error.message);\n            }\n            return result.value;\n        },\n\n        async signMessageWithDotNsIdentity(args) {\n            const message =\n                typeof args.message === \"string\"\n                    ? new TextEncoder().encode(args.message)\n                    : args.message;\n            const accountsProvider = await getHostAccountsProvider();\n            const username = args.username ?? (await getPrimaryUsername(accountsProvider));\n\n            // Reuse an already-connected People chain when the caller has\n            // wired one up via `app.chain.connect({ ..., <name>: peopleChain })`.\n            // Fall back to opening a transient connection so first-time users\n            // don't have to think about chain lifecycles. The chain-client\n            // module caches by genesis fingerprint, so subsequent\n            // signMessageWithDotNsIdentity calls share whichever connection\n            // got established first.\n            const peopleClient = isConnected(args.peopleChain)\n                ? getClient(args.peopleChain)\n                : await createChainClient({ chains: { people: args.peopleChain } }).then(\n                      (c) => c.raw.people,\n                  );\n            // PAPI's `TypedApi.query.X.Y.getValue` is variadic\n            // (`...args: [...WithCallOptions<Args>]`) so it's not assignable\n            // to our deliberately-narrow `(key) => Promise<...>` shape. The\n            // resolver only ever passes the storage key; the cast adapts the\n            // wider PAPI surface to the minimum we depend on.\n            const peopleApi = peopleClient.getTypedApi(\n                args.peopleChain,\n            ) as unknown as PeopleUsernameQueryApi;\n            const accountId = await resolvePeopleUsernameOwner(username, peopleApi);\n            if (!accountId) {\n                throw new Error(`No account owns DotNS username \"${username}\"`);\n            }\n\n            const owner = accountIdHexToBytes(accountId);\n            const signer = accountsProvider.getLegacyAccountSigner({\n                publicKey: owner,\n                name: username,\n            });\n\n            try {\n                return {\n                    username,\n                    accountId,\n                    signature: await signer.signBytes(message),\n                };\n            } catch (cause) {\n                throw new Error(\n                    `Failed to sign with DotNS username \"${username}\": ${\n                        cause instanceof Error ? cause.message : String(cause)\n                    }`,\n                    { cause },\n                );\n            }\n        },\n\n        onAccountChange(callback: (account: Account | null) => void): () => void {\n            accountChangeSubscribers.add(callback);\n            return () => accountChangeSubscribers.delete(callback);\n        },\n\n        getProductAccount(): Account | null {\n            // Product accounts require async call - this sync API can't support it properly\n            // Users should use SignerManager.getProductAccount() directly\n            log.warn(\n                \"getProductAccount() is deprecated - use SignerManager.getProductAccount() directly\",\n            );\n            return null;\n        },\n\n        getAnonymousAlias(): string | null {\n            // Anonymous aliases require async call - this sync API can't support it properly\n            // Users should use SignerManager.getProductAccountAlias() directly\n            log.warn(\n                \"getAnonymousAlias() is deprecated - use SignerManager.getProductAccountAlias() directly\",\n            );\n            return null;\n        },\n\n        async createProof(_message: Uint8Array): Promise<Uint8Array> {\n            // Ring VRF proofs require SignerManager.createRingVRFProof() directly\n            throw new Error(\n                \"createProof() is not implemented in the App API. \" +\n                    \"Use SignerManager.createRingVRFProof() directly.\",\n            );\n        },\n    };\n}\n\ntype HostAccountsProvider = NonNullable<Awaited<ReturnType<typeof getAccountsProvider>>>;\n\nasync function getHostAccountsProvider(): Promise<HostAccountsProvider> {\n    const provider = await getAccountsProvider();\n    if (!provider) {\n        throw new Error(\"Host accounts provider is not available\");\n    }\n    return provider;\n}\n\nasync function getPrimaryUsername(accountsProvider: HostAccountsProvider): Promise<string> {\n    const result = await accountsProvider.getUserId().match(\n        (value) => value,\n        (err) => {\n            throw err;\n        },\n    );\n    const username = result.primaryUsername.trim();\n    if (!username) {\n        throw new Error(\"Host identity did not provide a primary DotNS username\");\n    }\n    return username;\n}\n"]}

package/dist/chunk-BIKT6X54.js

@@ -1,70 +0,0 @@
-import { accountIdBytes } from '@parity/product-sdk-address';
-import { hexToBytes, bytesToHex } from '@parity/product-sdk-crypto';
-import { createLogger } from '@parity/product-sdk-logger';
-
-// src/identity/dotns.ts
-var log = createLogger("identity");
-function isValidDotNsName(name) {
-  if (!name.endsWith(".dot")) return false;
-  const label = name.slice(0, -4);
-  if (label.length < 3 || label.length > 63) return false;
-  return /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/.test(label);
-}
-function normalizeDotNsName(name) {
-  let normalized = name.toLowerCase().trim();
-  if (!normalized.endsWith(".dot")) {
-    normalized += ".dot";
-  }
-  return normalized;
-}
-async function resolveDotNs(name) {
-  const normalized = normalizeDotNsName(name);
-  if (!isValidDotNsName(normalized)) {
-    log.warn("Invalid DotNS name", { name });
-    return null;
-  }
-  log.debug("Resolving DotNS name", { name: normalized });
-  throw new Error(
-    "resolveDotNs() is not yet implemented. This is a skeleton for the Product SDK structure."
-  );
-}
-async function reverseDotNs(address) {
-  log.debug("Reverse resolving address", { address });
-  throw new Error(
-    "reverseDotNs() is not yet implemented. This is a skeleton for the Product SDK structure."
-  );
-}
-async function isDotNsAvailable(name) {
-  const record = await resolveDotNs(name).catch(() => null);
-  return record === null;
-}
-async function resolvePeopleUsernameOwner(username, peopleApi) {
-  const owner = await peopleApi.query.Resources.UsernameOwnerOf.getValue(
-    new TextEncoder().encode(username)
-  );
-  if (!owner) return null;
-  return accountIdBytesToHex(accountIdBytes(owner));
-}
-function assertHex(value) {
-  if (!/^0x[0-9a-fA-F]*$/.test(value)) {
-    throw new Error(`Expected 0x-prefixed hex string, got ${value}`);
-  }
-  return value;
-}
-function accountIdHexToBytes(accountId) {
-  const bytes = hexToBytes(assertHex(accountId).slice(2));
-  if (bytes.length !== 32) {
-    throw new Error(`Expected 32-byte AccountId, got ${bytes.length} bytes`);
-  }
-  return bytes;
-}
-function accountIdBytesToHex(bytes) {
-  if (bytes.length !== 32) {
-    throw new Error(`Expected 32-byte AccountId, got ${bytes.length} bytes`);
-  }
-  return `0x${bytesToHex(bytes)}`;
-}
-
-export { accountIdHexToBytes, isDotNsAvailable, isValidDotNsName, normalizeDotNsName, resolveDotNs, resolvePeopleUsernameOwner, reverseDotNs };
-//# sourceMappingURL=chunk-BIKT6X54.js.map
-//# sourceMappingURL=chunk-BIKT6X54.js.map

package/dist/chunk-BIKT6X54.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/identity/dotns.ts"],"names":[],"mappings":"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","file":"chunk-BIKT6X54.js","sourcesContent":["// Copyright 2026 Parity Technologies (UK) Ltd.\n// SPDX-License-Identifier: Apache-2.0\n/**\n * DotNS (Polkadot Name Service) utilities\n *\n * Provides name resolution for .dot domains\n */\n\nimport { accountIdBytes } from \"@parity/product-sdk-address\";\nimport { bytesToHex, hexToBytes } from \"@parity/product-sdk-crypto\";\nimport { createLogger } from \"@parity/product-sdk-logger\";\nimport type {\n    ChainDefinition,\n    PalletsTypedef,\n    PlainDescriptor,\n    RuntimeDescriptor,\n    SS58String,\n    StorageDescriptor,\n    TxDescriptor,\n} from \"polkadot-api\";\nimport type { DotNsRecord } from \"./types.js\";\n\nconst log = createLogger(\"identity\");\n\ntype AnyDescriptorEntry<T> = Record<string, Record<string, T>>;\n\ntype PeopleUsernameStorage = {\n    Resources: {\n        UsernameOwnerOf: StorageDescriptor<[Uint8Array], SS58String, true, never>;\n    };\n};\n\ntype PeopleUsernamePallets = PalletsTypedef<\n    PeopleUsernameStorage,\n    AnyDescriptorEntry<TxDescriptor<any>>,\n    AnyDescriptorEntry<PlainDescriptor<any>>,\n    AnyDescriptorEntry<PlainDescriptor<any>>,\n    AnyDescriptorEntry<PlainDescriptor<any>>,\n    AnyDescriptorEntry<RuntimeDescriptor<any, any>>\n>;\n\n/**\n * Descriptor narrowed to \"any chain that exposes `Resources.UsernameOwnerOf`\".\n *\n * Used as the input to `signMessageWithDotNsIdentity` so the SDK doesn't pin\n * a specific People-chain genesis — anything with the right storage shape\n * (paseo-individuality today, future People Lite, etc.) is accepted.\n */\nexport type PeopleUsernameChain = ChainDefinition & {\n    descriptors: Promise<unknown> & {\n        pallets: PeopleUsernamePallets;\n    };\n};\n\n/**\n * Minimal typed-api shape required to resolve a username on a People chain.\n *\n * This is a narrow structural type — anything with the right\n * `query.Resources.UsernameOwnerOf.getValue` shape works, including a real\n * `TypedApi<PeopleUsernameChain>` slice of a `ChainClient` or a hand-rolled\n * test double.\n */\nexport type PeopleUsernameQueryApi = {\n    query: {\n        Resources: {\n            UsernameOwnerOf: {\n                getValue: (key: Uint8Array) => Promise<SS58String | undefined>;\n            };\n        };\n    };\n};\n\n/**\n * Check if a string is a valid DotNS name\n *\n * @param name - Name to validate\n * @returns True if valid DotNS name\n */\nexport function isValidDotNsName(name: string): boolean {\n    // Basic validation: alphanumeric, hyphens, ends with .dot\n    if (!name.endsWith(\".dot\")) return false;\n    const label = name.slice(0, -4);\n    if (label.length < 3 || label.length > 63) return false;\n    return /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/.test(label);\n}\n\n/**\n * Normalize a DotNS name (lowercase, trim whitespace)\n *\n * @param name - Name to normalize\n * @returns Normalized name\n */\nexport function normalizeDotNsName(name: string): string {\n    let normalized = name.toLowerCase().trim();\n    if (!normalized.endsWith(\".dot\")) {\n        normalized += \".dot\";\n    }\n    return normalized;\n}\n\n/**\n * Resolve a DotNS name to an address.\n *\n * @deprecated Not implemented — throws at runtime. Use\n *   `wallet.signMessageWithDotNsIdentity({ peopleChain, username })` (which\n *   internally calls {@link resolvePeopleUsernameOwner}) for the supported\n *   People-chain username flow.\n *\n * @param name - DotNS name (e.g., \"alice.dot\")\n * @returns Resolved record or null if not found\n */\nexport async function resolveDotNs(name: string): Promise<DotNsRecord | null> {\n    const normalized = normalizeDotNsName(name);\n\n    if (!isValidDotNsName(normalized)) {\n        log.warn(\"Invalid DotNS name\", { name });\n        return null;\n    }\n\n    log.debug(\"Resolving DotNS name\", { name: normalized });\n\n    // TODO: Implement via PAPI query to DotNS pallet\n    throw new Error(\n        \"resolveDotNs() is not yet implemented. \" +\n            \"This is a skeleton for the Product SDK structure.\",\n    );\n}\n\n/**\n * Reverse resolve an address to a DotNS name.\n *\n * @deprecated Not implemented — throws at runtime. Reverse lookup will land\n *   alongside future identity work; for now resolve forward via\n *   `wallet.signMessageWithDotNsIdentity`.\n *\n * @param address - SS58 address\n * @returns Primary name or null if none set\n */\nexport async function reverseDotNs(address: string): Promise<string | null> {\n    log.debug(\"Reverse resolving address\", { address });\n\n    // TODO: Implement via PAPI query to DotNS pallet\n    throw new Error(\n        \"reverseDotNs() is not yet implemented. \" +\n            \"This is a skeleton for the Product SDK structure.\",\n    );\n}\n\n/**\n * Check if a DotNS name is available for registration.\n *\n * @deprecated Not implemented — depends on {@link resolveDotNs} which throws.\n *\n * @param name - Name to check\n * @returns True if available\n */\nexport async function isDotNsAvailable(name: string): Promise<boolean> {\n    const record = await resolveDotNs(name).catch(() => null);\n    return record === null;\n}\n\n/**\n * Resolve a People / People Lite username to its owning `AccountId32`.\n *\n * Queries `Resources.UsernameOwnerOf` on the caller-supplied typed-api fragment.\n * The returned value is the raw 32-byte account id as a `0x`-prefixed hex\n * string, or `null` when no owner is registered for that username.\n *\n * The `username` is UTF-8 encoded as-is — no normalization is applied. Pass\n * the exact byte string the chain stores (typically with the `.dot` suffix).\n *\n * @internal Exposed for unit testing. Consumers should use\n *   `wallet.signMessageWithDotNsIdentity` instead, which orchestrates the\n *   chain-connection lifecycle.\n */\nexport async function resolvePeopleUsernameOwner(\n    username: string,\n    peopleApi: PeopleUsernameQueryApi,\n): Promise<`0x${string}` | null> {\n    const owner = await peopleApi.query.Resources.UsernameOwnerOf.getValue(\n        new TextEncoder().encode(username),\n    );\n    if (!owner) return null;\n\n    return accountIdBytesToHex(accountIdBytes(owner));\n}\n\nfunction assertHex(value: string): `0x${string}` {\n    if (!/^0x[0-9a-fA-F]*$/.test(value)) {\n        throw new Error(`Expected 0x-prefixed hex string, got ${value}`);\n    }\n    return value as `0x${string}`;\n}\n\nexport function accountIdHexToBytes(accountId: `0x${string}`): Uint8Array {\n    const bytes = hexToBytes(assertHex(accountId).slice(2));\n    if (bytes.length !== 32) {\n        throw new Error(`Expected 32-byte AccountId, got ${bytes.length} bytes`);\n    }\n    return bytes;\n}\n\nfunction accountIdBytesToHex(bytes: Uint8Array): `0x${string}` {\n    if (bytes.length !== 32) {\n        throw new Error(`Expected 32-byte AccountId, got ${bytes.length} bytes`);\n    }\n    return `0x${bytesToHex(bytes)}`;\n}\n"]}

package/dist/dotns-DIaptENj.d.ts

@@ -1,167 +0,0 @@
-import { ChainDefinition, PalletsTypedef, StorageDescriptor, SS58String, TxDescriptor, PlainDescriptor, RuntimeDescriptor } from 'polkadot-api';
-
-/**
- * Identity module types
- *
- * Types for DotNS name resolution and context-alias derivation
- */
-/** DotNS name resolution result */
-interface DotNsRecord {
-    /** Resolved SS58 address */
-    address: string;
-    /** Name that was resolved */
-    name: string;
-    /** Owner address */
-    owner: string;
-    /** Expiration timestamp (if applicable) */
-    expiresAt?: number;
-}
-/**
- * Context alias info: a deterministic, context-bound alias derived from a parent account
- *
- * @deprecated Returned by `deriveContextAlias`, whose addresses no key can spend.
- *   Removal: `@parity/product-sdk` 0.23.0.
- */
-interface ContextAliasInfo {
-    /** Alias SS58 address */
-    address: string;
-    /** H160 EVM address */
-    h160Address: `0x${string}`;
-    /** Parent account address */
-    parentAddress: string;
-    /** Context string used for derivation */
-    context: string;
-}
-/** Identity verification result */
-interface VerificationResult {
-    /** Whether identity is verified */
-    verified: boolean;
-    /** Verification method used */
-    method: "on-chain" | "judgement" | "social";
-    /** Verification details */
-    details?: Record<string, unknown>;
-}
-/** On-chain identity info */
-interface OnChainIdentity {
-    /** Display name */
-    display?: string;
-    /** Legal name */
-    legal?: string;
-    /** Web URL */
-    web?: string;
-    /** Email */
-    email?: string;
-    /** Twitter handle */
-    twitter?: string;
-    /** Riot/Matrix handle */
-    riot?: string;
-    /** Additional fields */
-    additional: Array<[string, string]>;
-}
-
-/**
- * DotNS (Polkadot Name Service) utilities
- *
- * Provides name resolution for .dot domains
- */
-
-type AnyDescriptorEntry<T> = Record<string, Record<string, T>>;
-type PeopleUsernameStorage = {
-    Resources: {
-        UsernameOwnerOf: StorageDescriptor<[Uint8Array], SS58String, true, never>;
-    };
-};
-type PeopleUsernamePallets = PalletsTypedef<PeopleUsernameStorage, AnyDescriptorEntry<TxDescriptor<any>>, AnyDescriptorEntry<PlainDescriptor<any>>, AnyDescriptorEntry<PlainDescriptor<any>>, AnyDescriptorEntry<PlainDescriptor<any>>, AnyDescriptorEntry<RuntimeDescriptor<any, any>>>;
-/**
- * Descriptor narrowed to "any chain that exposes `Resources.UsernameOwnerOf`".
- *
- * Used as the input to `signMessageWithDotNsIdentity` so the SDK doesn't pin
- * a specific People-chain genesis — anything with the right storage shape
- * (paseo-individuality today, future People Lite, etc.) is accepted.
- */
-type PeopleUsernameChain = ChainDefinition & {
-    descriptors: Promise<unknown> & {
-        pallets: PeopleUsernamePallets;
-    };
-};
-/**
- * Minimal typed-api shape required to resolve a username on a People chain.
- *
- * This is a narrow structural type — anything with the right
- * `query.Resources.UsernameOwnerOf.getValue` shape works, including a real
- * `TypedApi<PeopleUsernameChain>` slice of a `ChainClient` or a hand-rolled
- * test double.
- */
-type PeopleUsernameQueryApi = {
-    query: {
-        Resources: {
-            UsernameOwnerOf: {
-                getValue: (key: Uint8Array) => Promise<SS58String | undefined>;
-            };
-        };
-    };
-};
-/**
- * Check if a string is a valid DotNS name
- *
- * @param name - Name to validate
- * @returns True if valid DotNS name
- */
-declare function isValidDotNsName(name: string): boolean;
-/**
- * Normalize a DotNS name (lowercase, trim whitespace)
- *
- * @param name - Name to normalize
- * @returns Normalized name
- */
-declare function normalizeDotNsName(name: string): string;
-/**
- * Resolve a DotNS name to an address.
- *
- * @deprecated Not implemented — throws at runtime. Use
- *   `wallet.signMessageWithDotNsIdentity({ peopleChain, username })` (which
- *   internally calls {@link resolvePeopleUsernameOwner}) for the supported
- *   People-chain username flow.
- *
- * @param name - DotNS name (e.g., "alice.dot")
- * @returns Resolved record or null if not found
- */
-declare function resolveDotNs(name: string): Promise<DotNsRecord | null>;
-/**
- * Reverse resolve an address to a DotNS name.
- *
- * @deprecated Not implemented — throws at runtime. Reverse lookup will land
- *   alongside future identity work; for now resolve forward via
- *   `wallet.signMessageWithDotNsIdentity`.
- *
- * @param address - SS58 address
- * @returns Primary name or null if none set
- */
-declare function reverseDotNs(address: string): Promise<string | null>;
-/**
- * Check if a DotNS name is available for registration.
- *
- * @deprecated Not implemented — depends on {@link resolveDotNs} which throws.
- *
- * @param name - Name to check
- * @returns True if available
- */
-declare function isDotNsAvailable(name: string): Promise<boolean>;
-/**
- * Resolve a People / People Lite username to its owning `AccountId32`.
- *
- * Queries `Resources.UsernameOwnerOf` on the caller-supplied typed-api fragment.
- * The returned value is the raw 32-byte account id as a `0x`-prefixed hex
- * string, or `null` when no owner is registered for that username.
- *
- * The `username` is UTF-8 encoded as-is — no normalization is applied. Pass
- * the exact byte string the chain stores (typically with the `.dot` suffix).
- *
- * @internal Exposed for unit testing. Consumers should use
- *   `wallet.signMessageWithDotNsIdentity` instead, which orchestrates the
- *   chain-connection lifecycle.
- */
-declare function resolvePeopleUsernameOwner(username: string, peopleApi: PeopleUsernameQueryApi): Promise<`0x${string}` | null>;
-declare function accountIdHexToBytes(accountId: `0x${string}`): Uint8Array;
-
-export { type ContextAliasInfo as C, type DotNsRecord as D, type OnChainIdentity as O, type PeopleUsernameChain as P, type VerificationResult as V, type PeopleUsernameQueryApi as a, accountIdHexToBytes as b, isValidDotNsName as c, resolvePeopleUsernameOwner as d, reverseDotNs as e, isDotNsAvailable as i, normalizeDotNsName as n, resolveDotNs as r };