enskit 0.0.1 → 1.10.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NameHash
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/react/index.d.ts

@@ -0,0 +1,39 @@
+import { LiteralName, InterpretedName, literalNameToInterpretedName } from 'enssdk';
+import { ReactNode } from 'react';
+
+type MalformedNameRenderer = (name: string) => ReactNode;
+type InterpretedNameRenderer = (name: InterpretedName) => ReactNode;
+/**
+ * Renders a {@link LiteralName} by ensuring it is an {@link InterpretedName}. This is useful for
+ * ensuring that downstream components get the guarantees of an {@link InterpretedName}.
+ *
+ * @param name - The user-provided {@link LiteralName} to render.
+ * @param children - Render prop called with the {@link InterpretedName} when `name` is already interpreted.
+ * @param coerced - Render prop called with the coerced {@link InterpretedName} when `name` was not already
+ *   interpreted but could be successfully coerced under `options`. Typically used to redirect the user to the
+ *   canonical URL.
+ * @param malformed - Render prop called with the original literal string when `name` cannot be coerced into an
+ *   {@link InterpretedName} under `options`.
+ * @param options - Forwarded to {@link literalNameToInterpretedName}. Controls how the interpretation handles edge
+ *   cases. When `options.allowENSRootName` is `true`, an empty `name` is accepted and rendered via `children`; when
+ *   `false` (default), an empty `name` falls through to `malformed`. When `options.allowEncodedLabelHashes` is
+ *   `true`, a Label already formatted as an EncodedLabelHash is preserved verbatim; when `false` (default), such a
+ *   Label is treated like any other input and passed through normalization, which will fail and fall through to the
+ *   unnormalizable-Label handling. When `options.coerceUnnormalizedLabelsToNormalizedLabels` is `true` (default), an
+ *   unnormalized Label is passed through ENSIP-15 normalization (e.g. `"Vitalik"` → `"vitalik"`); when `false`, any
+ *   unnormalized Label causes `malformed` to be invoked — no normalization is attempted and
+ *   `coerceUnnormalizableLabelsToEncodedLabelHashes` is not consulted. When
+ *   `options.coerceUnnormalizableLabelsToEncodedLabelHashes` is `true`, a Label that cannot be normalized is replaced
+ *   with the EncodedLabelHash of its literal bytes and `coerced` is invoked; when `false` (default), encountering
+ *   such a Label causes `malformed` to be invoked. Only consulted when
+ *   `coerceUnnormalizedLabelsToNormalizedLabels` is `true`.
+ */
+declare function EnsureInterpretedName({ name, children, coerced, malformed, options, }: {
+    name: LiteralName;
+    children: InterpretedNameRenderer;
+    coerced: InterpretedNameRenderer;
+    malformed: MalformedNameRenderer;
+    options?: Parameters<typeof literalNameToInterpretedName>[1];
+}): ReactNode;
+
+export { EnsureInterpretedName };

package/dist/react/index.js

@@ -0,0 +1,22 @@
+// src/react/components/ensure-interpreted-name.tsx
+import { literalNameToInterpretedName } from "enssdk";
+function EnsureInterpretedName({
+  name,
+  children,
+  coerced,
+  malformed,
+  options
+}) {
+  let interpreted;
+  try {
+    interpreted = literalNameToInterpretedName(name, options);
+  } catch {
+    return malformed(name);
+  }
+  if (name !== interpreted) return coerced(interpreted);
+  return children(interpreted);
+}
+export {
+  EnsureInterpretedName
+};
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/components/ensure-interpreted-name.tsx"],"sourcesContent":["import { type InterpretedName, type LiteralName, literalNameToInterpretedName } from \"enssdk\";\nimport type { ReactNode } from \"react\";\n\ntype MalformedNameRenderer = (name: string) => ReactNode;\ntype InterpretedNameRenderer = (name: InterpretedName) => ReactNode;\n\n/**\n * Renders a {@link LiteralName} by ensuring it is an {@link InterpretedName}. This is useful for\n * ensuring that downstream components get the guarantees of an {@link InterpretedName}.\n *\n * @param name - The user-provided {@link LiteralName} to render.\n * @param children - Render prop called with the {@link InterpretedName} when `name` is already interpreted.\n * @param coerced - Render prop called with the coerced {@link InterpretedName} when `name` was not already\n *   interpreted but could be successfully coerced under `options`. Typically used to redirect the user to the\n *   canonical URL.\n * @param malformed - Render prop called with the original literal string when `name` cannot be coerced into an\n *   {@link InterpretedName} under `options`.\n * @param options - Forwarded to {@link literalNameToInterpretedName}. Controls how the interpretation handles edge\n *   cases. When `options.allowENSRootName` is `true`, an empty `name` is accepted and rendered via `children`; when\n *   `false` (default), an empty `name` falls through to `malformed`. When `options.allowEncodedLabelHashes` is\n *   `true`, a Label already formatted as an EncodedLabelHash is preserved verbatim; when `false` (default), such a\n *   Label is treated like any other input and passed through normalization, which will fail and fall through to the\n *   unnormalizable-Label handling. When `options.coerceUnnormalizedLabelsToNormalizedLabels` is `true` (default), an\n *   unnormalized Label is passed through ENSIP-15 normalization (e.g. `\"Vitalik\"` → `\"vitalik\"`); when `false`, any\n *   unnormalized Label causes `malformed` to be invoked — no normalization is attempted and\n *   `coerceUnnormalizableLabelsToEncodedLabelHashes` is not consulted. When\n *   `options.coerceUnnormalizableLabelsToEncodedLabelHashes` is `true`, a Label that cannot be normalized is replaced\n *   with the EncodedLabelHash of its literal bytes and `coerced` is invoked; when `false` (default), encountering\n *   such a Label causes `malformed` to be invoked. Only consulted when\n *   `coerceUnnormalizedLabelsToNormalizedLabels` is `true`.\n */\nexport function EnsureInterpretedName({\n  name,\n  children,\n  coerced,\n  malformed,\n  options,\n}: {\n  name: LiteralName;\n  children: InterpretedNameRenderer;\n  coerced: InterpretedNameRenderer;\n  malformed: MalformedNameRenderer;\n  options?: Parameters<typeof literalNameToInterpretedName>[1];\n}) {\n  // attempt to convert the LiteralName to an InterpretedName\n  let interpreted: InterpretedName;\n  try {\n    interpreted = literalNameToInterpretedName(name, options);\n  } catch {\n    // this name can't conform to InterpretedName: it is malformed or contains unnormalizable Labels\n    return malformed(name);\n  }\n\n  // from here, the name is either already interpreted or was coerced; check with string equality\n  if ((name as string) !== (interpreted as string)) return coerced(interpreted);\n\n  // the name was already interpreted, render the happy path\n  return children(interpreted);\n}\n"],"mappings":";AAAA,SAAiD,oCAAoC;AA+B9E,SAAS,sBAAsB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMG;AAED,MAAI;AACJ,MAAI;AACF,kBAAc,6BAA6B,MAAM,OAAO;AAAA,EAC1D,QAAQ;AAEN,WAAO,UAAU,IAAI;AAAA,EACvB;AAGA,MAAK,SAAqB,YAAwB,QAAO,QAAQ,WAAW;AAG5E,SAAO,SAAS,WAAW;AAC7B;","names":[]}

package/dist/react/omnigraph/index.d.ts

@@ -0,0 +1,32 @@
+import { introspection, OmnigraphScalars } from 'enssdk/omnigraph';
+import { initGraphQLTada, TadaDocumentNode } from 'gql.tada';
+export { FragmentOf, ResultOf, VariablesOf, readFragment } from 'gql.tada';
+import { AnyVariables, OperationContext } from '@urql/core';
+import { DocumentNode } from 'graphql';
+import { UseQueryResponse } from 'urql';
+import { EnsNodeClient } from 'enssdk/core';
+import { ReactNode, ReactElement } from 'react';
+
+declare const graphql: initGraphQLTada<{
+    introspection: typeof introspection;
+    scalars: Omit<OmnigraphScalars, "BigInt"> & {
+        BigInt: bigint;
+    };
+}>;
+
+type UseOmnigraphQueryArgs<Data = unknown, Variables extends AnyVariables = AnyVariables> = {
+    query: DocumentNode | TadaDocumentNode<Data, Variables> | string;
+    variables?: Variables;
+    pause?: boolean;
+    context?: Partial<OperationContext>;
+};
+type UseOmnigraphQueryResult<Data = unknown, Variables extends AnyVariables = AnyVariables> = UseQueryResponse<Data, Variables>;
+declare function useOmnigraphQuery<Data = unknown, Variables extends AnyVariables = AnyVariables>(args: UseOmnigraphQueryArgs<Data, Variables>): UseOmnigraphQueryResult<Data, Variables>;
+
+interface OmnigraphProviderProps {
+    client: EnsNodeClient;
+    children?: ReactNode;
+}
+declare function OmnigraphProvider({ client, children }: OmnigraphProviderProps): ReactElement;
+
+export { OmnigraphProvider, type OmnigraphProviderProps, type UseOmnigraphQueryArgs, type UseOmnigraphQueryResult, graphql, useOmnigraphQuery };

package/dist/react/omnigraph/index.js

@@ -0,0 +1,187 @@
+// src/react/omnigraph/graphql.ts
+import { initGraphQLTada } from "gql.tada";
+import { readFragment } from "gql.tada";
+var graphql = initGraphQLTada();
+
+// src/react/omnigraph/hooks.ts
+import { useQuery } from "urql";
+function useOmnigraphQuery(args) {
+  return useQuery({
+    query: args.query,
+    variables: args.variables,
+    pause: args.pause,
+    context: args.context
+  });
+}
+
+// src/react/omnigraph/provider.tsx
+import { createElement, useMemo } from "react";
+import { Provider } from "urql";
+
+// src/react/omnigraph/client.ts
+import { Client, fetchExchange } from "@urql/core";
+
+// src/react/omnigraph/_lib/cache-exchange.ts
+import { cacheExchange } from "@urql/exchange-graphcache";
+import { stringifyAccountId } from "enssdk";
+import { introspection } from "enssdk/omnigraph";
+
+// src/react/omnigraph/_lib/by-id-lookup-resolvers.ts
+import {
+  makePermissionsId,
+  makeRegistryId,
+  makeResolverId
+} from "enssdk";
+var passthrough = (args, cache, info) => cache.resolve(info.parentTypeName, info.fieldName, args);
+var byIdLookupResolvers = {
+  Query: {
+    domain(parent, args, cache, info) {
+      const by = args.by;
+      if (by.id) {
+        const v1Key = cache.keyOfEntity({ __typename: "ENSv1Domain", id: by.id });
+        if (v1Key && cache.resolve(v1Key, "id")) return v1Key;
+        const v2Key = cache.keyOfEntity({ __typename: "ENSv2Domain", id: by.id });
+        if (v2Key && cache.resolve(v2Key, "id")) return v2Key;
+      }
+      return passthrough(args, cache, info);
+    },
+    account(parent, args, cache, info) {
+      const by = args.by;
+      if (by.id) return { __typename: "Account", id: by.id };
+      if (by.address) return { __typename: "Account", id: by.address };
+      return passthrough(args, cache, info);
+    },
+    registry(parent, args, cache, info) {
+      const by = args.by;
+      if (by.id) return { __typename: "Registry", id: by.id };
+      if (by.contract) return { __typename: "Registry", id: makeRegistryId(by.contract) };
+      return passthrough(args, cache, info);
+    },
+    resolver(parent, args, cache, info) {
+      const by = args.by;
+      if (by.id) return { __typename: "Resolver", id: by.id };
+      if (by.contract) return { __typename: "Resolver", id: makeResolverId(by.contract) };
+      return passthrough(args, cache, info);
+    },
+    permissions(parent, args, cache, info) {
+      const by = args.by;
+      if (by.id) return { __typename: "Permissions", id: by.id };
+      if (by.contract) return { __typename: "Permissions", id: makePermissionsId(by.contract) };
+      return passthrough(args, cache, info);
+    }
+  }
+};
+
+// src/react/omnigraph/_lib/introspection-helpers.ts
+function unwrapType(type) {
+  return type.ofType ? unwrapType(type.ofType) : type;
+}
+
+// src/react/omnigraph/_lib/local-bigint-resolvers.ts
+var toBigInt = (parent, args, cache, info) => {
+  const value = parent[info.fieldName];
+  if (value == null) return value;
+  return BigInt(value);
+};
+var toBigIntList = (parent, args, cache, info) => {
+  const value = parent[info.fieldName];
+  if (value == null) return value;
+  return value.map((v) => v == null ? v : BigInt(v));
+};
+function isBigIntType(type) {
+  return unwrapType(type).name === "BigInt";
+}
+function isListType(type) {
+  if (type.kind === "LIST") return true;
+  return type.ofType ? isListType(type.ofType) : false;
+}
+function localBigIntResolvers(schema) {
+  const resolvers = {};
+  for (const type of schema.__schema.types) {
+    if (type.kind !== "OBJECT" || type.name.startsWith("__")) continue;
+    for (const field of type.fields ?? []) {
+      if (!isBigIntType(field.type)) continue;
+      resolvers[type.name] ??= {};
+      resolvers[type.name][field.name] = isListType(field.type) ? toBigIntList : toBigInt;
+    }
+  }
+  return resolvers;
+}
+
+// src/react/omnigraph/_lib/local-connection-resolvers.ts
+import { relayPagination } from "@urql/exchange-graphcache/extras";
+function localConnectionResolvers(schema) {
+  const resolvers = {};
+  for (const type of schema.__schema.types) {
+    if (type.kind !== "OBJECT" || type.name.startsWith("__")) continue;
+    for (const field of type.fields ?? []) {
+      const leaf = unwrapType(field.type);
+      if (leaf.name?.endsWith("Connection")) {
+        resolvers[type.name] ??= {};
+        resolvers[type.name][field.name] = relayPagination();
+      }
+    }
+  }
+  return resolvers;
+}
+
+// src/react/omnigraph/_lib/merge-resolver-maps.ts
+function mergeResolverMaps(...maps) {
+  const result = {};
+  for (const map of maps) {
+    for (const [typeName, fields] of Object.entries(map)) {
+      result[typeName] = { ...result[typeName], ...fields };
+    }
+  }
+  return result;
+}
+
+// src/react/omnigraph/_lib/cache-exchange.ts
+var EMBEDDED_DATA = () => null;
+var omnigraphCacheExchange = cacheExchange({
+  schema: introspection,
+  keys: {
+    // by default, all Entities are assumed to match the Relay spec, and graphcache treats
+    // them as keyable by `id`. if it encounters an Entity with no `id` field and no other
+    // special handling here in the cacheExchange.keys definitions, it will issue a warning.
+    // AccountIds are keyable by stringifying them
+    AccountId: (data) => {
+      if (!data.address) return null;
+      if (!data.chainId) return null;
+      return stringifyAccountId(data);
+    },
+    // These entities are Embedded Data and don't have a relevant key
+    Label: EMBEDDED_DATA,
+    WrappedBaseRegistrarRegistration: EMBEDDED_DATA
+  },
+  resolvers: mergeResolverMaps(
+    // produce relayPagination() local resolvers for each t.connection in the schema
+    localConnectionResolvers(introspection),
+    // produce local resolvers that parse BigInt scalar fields from cached strings into native bigint
+    localBigIntResolvers(introspection),
+    // produce local cache resolvers for the Query.entity(by: { }) lookups
+    byIdLookupResolvers
+  )
+});
+
+// src/react/omnigraph/client.ts
+function createOmnigraphUrqlClient(config) {
+  return new Client({
+    url: new URL("/api/omnigraph", config.url).href,
+    fetch: config.fetch,
+    exchanges: [omnigraphCacheExchange, fetchExchange]
+  });
+}
+
+// src/react/omnigraph/provider.tsx
+function OmnigraphProvider({ client, children }) {
+  const urqlClient = useMemo(() => createOmnigraphUrqlClient(client.config), [client]);
+  return createElement(Provider, { value: urqlClient }, children);
+}
+export {
+  OmnigraphProvider,
+  graphql,
+  readFragment,
+  useOmnigraphQuery
+};
+//# sourceMappingURL=index.js.map

package/dist/react/omnigraph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/react/omnigraph/graphql.ts","../../../src/react/omnigraph/hooks.ts","../../../src/react/omnigraph/provider.tsx","../../../src/react/omnigraph/client.ts","../../../src/react/omnigraph/_lib/cache-exchange.ts","../../../src/react/omnigraph/_lib/by-id-lookup-resolvers.ts","../../../src/react/omnigraph/_lib/introspection-helpers.ts","../../../src/react/omnigraph/_lib/local-bigint-resolvers.ts","../../../src/react/omnigraph/_lib/local-connection-resolvers.ts","../../../src/react/omnigraph/_lib/merge-resolver-maps.ts"],"sourcesContent":["import type { introspection, OmnigraphScalars } from \"enssdk/omnigraph\";\nimport { initGraphQLTada } from \"gql.tada\";\n\nexport const graphql = initGraphQLTada<{\n  introspection: typeof introspection;\n  scalars: Omit<OmnigraphScalars, \"BigInt\"> & {\n    // override the default Omnigraph Scalar definitions to include a deserialized BigInt (see cache-exchange.ts)\n    BigInt: bigint;\n  };\n}>();\n\nexport type { FragmentOf, ResultOf, VariablesOf } from \"gql.tada\";\nexport { readFragment } from \"gql.tada\";\n","\"use client\";\n\nimport type { AnyVariables, OperationContext } from \"@urql/core\";\nimport type { TadaDocumentNode } from \"gql.tada\";\nimport type { DocumentNode } from \"graphql\";\nimport { type UseQueryResponse, useQuery } from \"urql\";\n\nexport type UseOmnigraphQueryArgs<Data = unknown, Variables extends AnyVariables = AnyVariables> = {\n  query: DocumentNode | TadaDocumentNode<Data, Variables> | string;\n  variables?: Variables;\n  pause?: boolean;\n  context?: Partial<OperationContext>;\n};\n\nexport type UseOmnigraphQueryResult<\n  Data = unknown,\n  Variables extends AnyVariables = AnyVariables,\n> = UseQueryResponse<Data, Variables>;\n\nexport function useOmnigraphQuery<Data = unknown, Variables extends AnyVariables = AnyVariables>(\n  args: UseOmnigraphQueryArgs<Data, Variables>,\n): UseOmnigraphQueryResult<Data, Variables> {\n  return useQuery<Data, Variables>({\n    query: args.query as DocumentNode,\n    variables: args.variables as Variables,\n    pause: args.pause,\n    context: args.context,\n  });\n}\n","\"use client\";\n\nimport type { EnsNodeClient } from \"enssdk/core\";\nimport { createElement, type ReactElement, type ReactNode, useMemo } from \"react\";\nimport { Provider } from \"urql\";\n\nimport { createOmnigraphUrqlClient } from \"./client\";\n\nexport interface OmnigraphProviderProps {\n  client: EnsNodeClient;\n  children?: ReactNode;\n}\n\nexport function OmnigraphProvider({ client, children }: OmnigraphProviderProps): ReactElement {\n  const urqlClient = useMemo(() => createOmnigraphUrqlClient(client.config), [client]);\n\n  return createElement(Provider, { value: urqlClient }, children);\n}\n","import { Client, fetchExchange } from \"@urql/core\";\nimport type { EnsNodeClientConfig } from \"enssdk/core\";\n\nimport { omnigraphCacheExchange } from \"./_lib/cache-exchange\";\n\nexport function createOmnigraphUrqlClient(config: EnsNodeClientConfig) {\n  return new Client({\n    url: new URL(\"/api/omnigraph\", config.url).href,\n    fetch: config.fetch,\n    exchanges: [omnigraphCacheExchange, fetchExchange],\n  });\n}\n","import { cacheExchange } from \"@urql/exchange-graphcache\";\nimport type { AccountId } from \"enssdk\";\nimport { stringifyAccountId } from \"enssdk\";\nimport { introspection } from \"enssdk/omnigraph\";\n\nimport { byIdLookupResolvers } from \"./by-id-lookup-resolvers\";\nimport { localBigIntResolvers } from \"./local-bigint-resolvers\";\nimport { localConnectionResolvers } from \"./local-connection-resolvers\";\nimport { mergeResolverMaps } from \"./merge-resolver-maps\";\n\n/**\n * Entities without keys are 'Embedded Data', and we tell graphcache about them to avoid warnings\n * about the inability to normalize them.\n *\n * @see https://nearform.com/open-source/urql/docs/graphcache/normalized-caching/#custom-keys-and-non-keyable-entities\n */\nconst EMBEDDED_DATA = () => null;\n\nexport const omnigraphCacheExchange = cacheExchange({\n  schema: introspection,\n  keys: {\n    // by default, all Entities are assumed to match the Relay spec, and graphcache treats\n    // them as keyable by `id`. if it encounters an Entity with no `id` field and no other\n    // special handling here in the cacheExchange.keys definitions, it will issue a warning.\n\n    // AccountIds are keyable by stringifying them\n    AccountId: (data) => {\n      if (!data.address) return null;\n      if (!data.chainId) return null;\n\n      return stringifyAccountId(data as unknown as AccountId);\n    },\n\n    // These entities are Embedded Data and don't have a relevant key\n    Label: EMBEDDED_DATA,\n    WrappedBaseRegistrarRegistration: EMBEDDED_DATA,\n  },\n  resolvers: mergeResolverMaps(\n    // produce relayPagination() local resolvers for each t.connection in the schema\n    localConnectionResolvers(introspection),\n\n    // produce local resolvers that parse BigInt scalar fields from cached strings into native bigint\n    localBigIntResolvers(introspection),\n\n    // produce local cache resolvers for the Query.entity(by: { }) lookups\n    byIdLookupResolvers,\n  ),\n});\n","import type { Cache, ResolveInfo, Resolver, Variables } from \"@urql/exchange-graphcache\";\nimport {\n  type AccountId,\n  type Address,\n  makePermissionsId,\n  makeRegistryId,\n  makeResolverId,\n  type PermissionsId,\n  type RegistryId,\n  type ResolverId,\n} from \"enssdk\";\n\n/**\n * This local resolver delegates to graphcache's built-in cache resolution with the full argument set,\n * effectively telling urql 'not found locally' and to fetch from the network.\n */\nconst passthrough = (args: Variables, cache: Cache, info: ResolveInfo) =>\n  cache.resolve(info.parentTypeName, info.fieldName, args);\n\nexport const byIdLookupResolvers: Record<string, Record<string, Resolver>> = {\n  Query: {\n    domain(parent, args, cache, info) {\n      const by = args.by as { id?: string; name?: string };\n\n      if (by.id) {\n        const v1Key = cache.keyOfEntity({ __typename: \"ENSv1Domain\", id: by.id });\n        if (v1Key && cache.resolve(v1Key, \"id\")) return v1Key;\n\n        const v2Key = cache.keyOfEntity({ __typename: \"ENSv2Domain\", id: by.id });\n        if (v2Key && cache.resolve(v2Key, \"id\")) return v2Key;\n      }\n\n      return passthrough(args, cache, info);\n    },\n    account(parent, args, cache, info) {\n      const by = args.by as { id?: Address; address?: Address };\n\n      if (by.id) return { __typename: \"Account\", id: by.id };\n      if (by.address) return { __typename: \"Account\", id: by.address };\n\n      return passthrough(args, cache, info);\n    },\n    registry(parent, args, cache, info) {\n      const by = args.by as { id?: RegistryId; contract?: AccountId };\n\n      if (by.id) return { __typename: \"Registry\", id: by.id };\n      if (by.contract) return { __typename: \"Registry\", id: makeRegistryId(by.contract) };\n\n      return passthrough(args, cache, info);\n    },\n    resolver(parent, args, cache, info) {\n      const by = args.by as { id?: ResolverId; contract?: AccountId };\n\n      if (by.id) return { __typename: \"Resolver\", id: by.id };\n      if (by.contract) return { __typename: \"Resolver\", id: makeResolverId(by.contract) };\n\n      return passthrough(args, cache, info);\n    },\n    permissions(parent, args, cache, info) {\n      const by = args.by as { id?: PermissionsId; contract?: AccountId };\n\n      if (by.id) return { __typename: \"Permissions\", id: by.id };\n      if (by.contract) return { __typename: \"Permissions\", id: makePermissionsId(by.contract) };\n\n      return passthrough(args, cache, info);\n    },\n  },\n};\n","export interface IntrospectionTypeRef {\n  readonly kind: string;\n  readonly name?: string;\n  readonly ofType?: IntrospectionTypeRef | null;\n}\n\nexport interface IntrospectionField {\n  readonly name: string;\n  readonly type: IntrospectionTypeRef;\n}\n\nexport interface IntrospectionType {\n  readonly kind: string;\n  readonly name: string;\n  readonly fields?: readonly IntrospectionField[] | null;\n}\n\nexport interface IntrospectionSchema {\n  readonly __schema: {\n    readonly types: readonly IntrospectionType[];\n  };\n}\n\nexport function unwrapType(type: IntrospectionTypeRef): IntrospectionTypeRef {\n  return type.ofType ? unwrapType(type.ofType) : type;\n}\n","import type { Resolver, ScalarObject } from \"@urql/exchange-graphcache\";\n\nimport {\n  type IntrospectionSchema,\n  type IntrospectionTypeRef,\n  unwrapType,\n} from \"./introspection-helpers\";\n\n// graphcache's ResolverResult type doesn't include bigint, but the value is stored\n// in the normalized cache and returned to the consumer as-is, so bigint works at runtime\n// the load-bearing piece of type inference is in packages/enskit/src/react/omnigraph/graphql.ts where\n// the GraphQL BigInt Scalar is mapped to the `bigint` primitive, which is only supported by these\n// runtime local resolvers.\nconst toBigInt: Resolver = (parent, args, cache, info) => {\n  const value = parent[info.fieldName];\n  if (value == null) return value;\n  return BigInt(value as string) as unknown as ScalarObject;\n};\n\nconst toBigIntList: Resolver = (parent, args, cache, info) => {\n  const value = parent[info.fieldName];\n  if (value == null) return value;\n\n  // now we know value is a (string | null)[], so map to a (bigint | null)[]\n  return (value as readonly (string | null)[]).map((v) => (v == null ? v : BigInt(v)));\n};\n\nfunction isBigIntType(type: IntrospectionTypeRef) {\n  return unwrapType(type).name === \"BigInt\";\n}\n\n// NOTE: the recursion is to handle not-null-wrapped lists\nfunction isListType(type: IntrospectionTypeRef): boolean {\n  if (type.kind === \"LIST\") return true;\n  return type.ofType ? isListType(type.ofType) : false;\n}\n\n/**\n * Derives local resolvers that parse BigInt scalar fields from cached strings into native bigint.\n */\nexport function localBigIntResolvers(\n  schema: IntrospectionSchema,\n): Record<string, Record<string, Resolver>> {\n  const resolvers: Record<string, Record<string, Resolver>> = {};\n\n  for (const type of schema.__schema.types) {\n    if (type.kind !== \"OBJECT\" || type.name.startsWith(\"__\")) continue;\n\n    for (const field of type.fields ?? []) {\n      if (!isBigIntType(field.type)) continue;\n\n      resolvers[type.name] ??= {};\n      resolvers[type.name][field.name] = isListType(field.type) ? toBigIntList : toBigInt;\n    }\n  }\n\n  return resolvers;\n}\n","import type { Resolver } from \"@urql/exchange-graphcache\";\nimport { relayPagination } from \"@urql/exchange-graphcache/extras\";\n\nimport { type IntrospectionSchema, unwrapType } from \"./introspection-helpers\";\n\n/**\n * Derives `relayPagination()` local resolvers for all connection fields in the schema.\n */\nexport function localConnectionResolvers(\n  schema: IntrospectionSchema,\n): Record<string, Record<string, Resolver>> {\n  const resolvers: Record<string, Record<string, Resolver>> = {};\n\n  for (const type of schema.__schema.types) {\n    if (type.kind !== \"OBJECT\" || type.name.startsWith(\"__\")) continue;\n\n    for (const field of type.fields ?? []) {\n      const leaf = unwrapType(field.type);\n      if (leaf.name?.endsWith(\"Connection\")) {\n        resolvers[type.name] ??= {};\n        resolvers[type.name][field.name] = relayPagination();\n      }\n    }\n  }\n\n  return resolvers;\n}\n","import type { Resolver } from \"@urql/exchange-graphcache\";\n\n/**\n * deep-merge resolver maps so types appearing in both get all their field resolvers\n */\nexport function mergeResolverMaps<RESOLVER extends Resolver>(\n  ...maps: Record<string, Record<string, RESOLVER>>[]\n): Record<string, Record<string, RESOLVER>> {\n  const result: Record<string, Record<string, RESOLVER>> = {};\n  for (const map of maps) {\n    for (const [typeName, fields] of Object.entries(map)) {\n      result[typeName] = { ...result[typeName], ...fields };\n    }\n  }\n  return result;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,12 +1,66 @@
 {
   "name": "enskit",
-  "version": "0.0.1",
-  "description": "Reserved for the ENSNode project by NameHash Labs. See https://ensnode.io",
+  "version": "1.10.1",
+  "type": "module",
+  "description": "The ENS toolkit for React applications",
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/namehash/ensnode.git",
+    "url": "git+https://github.com/namehash/ensnode.git",
     "directory": "packages/enskit"
   },
-  "license": "MIT",
-  "homepage": "https://ensnode.io"
-}
+  "homepage": "https://ensnode.io",
+  "keywords": [
+    "ENS",
+    "ENSNode",
+    "React",
+    "Omnigraph"
+  ],
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    },
+    "./react/omnigraph": {
+      "types": "./dist/react/omnigraph/index.d.ts",
+      "default": "./dist/react/omnigraph/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@urql/core": "^6.0.0",
+    "@urql/exchange-graphcache": "^9.0.0",
+    "urql": "^5.0.1",
+    "enssdk": "1.10.1"
+  },
+  "peerDependencies": {
+    "gql.tada": "^1.8.10",
+    "graphql": "^16",
+    "react": "^18.0.0 || ^19.0.0",
+    "viem": "^2"
+  },
+  "devDependencies": {
+    "@types/react": "19.2.7",
+    "gql.tada": "^1.8.10",
+    "graphql": "^16.11.0",
+    "react": "19.2.1",
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "viem": "^2.22.13",
+    "vitest": "^4.0.2",
+    "@ensnode/shared-configs": "1.10.1"
+  },
+  "scripts": {
+    "prepublish": "tsup",
+    "lint": "biome check --write .",
+    "lint:ci": "biome ci",
+    "test": "vitest",
+    "typecheck": "tsgo --noEmit"
+  }
+}