@seed-hypermedia/client 0.0.13 → 0.0.14

package/dist/{chunk-LCXR7GLM.mjs → chunk-B6GAAJII.mjs}

@@ -941,6 +941,34 @@ var HMListCommentVersionsRequestSchema = z.object({
   input: HMListCommentVersionsInputSchema,
   output: HMListCommentVersionsOutputSchema
 });
+var HMDomainInfoSchema = z.object({
+  domain: z.string(),
+  lastCheck: z.date().nullable(),
+  status: z.string(),
+  lastSuccess: z.date().nullable(),
+  registeredAccountUid: z.string().nullable(),
+  peerId: z.string().nullable(),
+  lastError: z.string().nullable()
+});
+var HMGetDomainInputSchema = z.object({
+  domain: z.string(),
+  /** If true, forces a fresh HTTP check instead of returning cached data. */
+  forceCheck: z.boolean().optional()
+});
+var HMGetDomainRequestSchema = z.object({
+  key: z.literal("GetDomain"),
+  input: HMGetDomainInputSchema,
+  output: HMDomainInfoSchema
+});
+var HMListDomainsInputSchema = z.object({});
+var HMListDomainsOutputSchema = z.object({
+  domains: z.array(HMDomainInfoSchema)
+});
+var HMListDomainsRequestSchema = z.object({
+  key: z.literal("ListDomains"),
+  input: HMListDomainsInputSchema,
+  output: HMListDomainsOutputSchema
+});
 var HMGetRequestSchema = z.discriminatedUnion("key", [
   HMResourceRequestSchema,
   HMResourceMetadataRequestSchema,
@@ -962,7 +990,9 @@ var HMGetRequestSchema = z.discriminatedUnion("key", [
   HMListChangesRequestSchema,
   HMListCapabilitiesRequestSchema,
   HMInteractionSummaryRequestSchema,
-  HMListCommentVersionsRequestSchema
+  HMListCommentVersionsRequestSchema,
+  HMGetDomainRequestSchema,
+  HMListDomainsRequestSchema
 ]);
 var HMActionSchema = z.discriminatedUnion("key", [
   HMPublishBlobsRequestSchema,
@@ -990,6 +1020,8 @@ var HMRequestSchema = z.discriminatedUnion("key", [
   HMListCapabilitiesRequestSchema,
   HMInteractionSummaryRequestSchema,
   HMListCommentVersionsRequestSchema,
+  HMGetDomainRequestSchema,
+  HMListDomainsRequestSchema,
   HMPublishBlobsRequestSchema,
   HMPrepareDocumentChangeRequestSchema
 ]);
@@ -1148,87 +1180,6 @@ function isSurrogate(s, i) {
   const code = s.charCodeAt(i);
   return 55296 <= code && code <= 56319;
 }
-async function resolveHypermediaUrl(url) {
-  let latest = false;
-  let blockRef = null;
-  let blockRange = null;
-  let panel = null;
-  try {
-    const parsedUrl = new URL(url);
-    const hasVersion = parsedUrl.searchParams.has("v");
-    const hasLatest = parsedUrl.searchParams.has("l");
-    panel = parsedUrl.searchParams.get("panel");
-    if (parsedUrl.hash) {
-      const fragment = parseFragment(parsedUrl.hash.slice(1));
-      if (fragment) {
-        blockRef = fragment.blockId;
-        if ("start" in fragment && fragment.start !== void 0) {
-          blockRange = { start: fragment.start, end: fragment.end };
-        } else if ("expanded" in fragment && fragment.expanded) {
-          blockRange = { expanded: fragment.expanded };
-        }
-      }
-    }
-    latest = blockRef ? false : hasLatest || !hasVersion;
-  } catch {
-  }
-  const response = await fetch(url, {
-    method: "OPTIONS"
-  });
-  if (response.status === 200) {
-    const rawId = response.headers.get("x-hypermedia-id");
-    const id = rawId ? decodeURIComponent(rawId) : null;
-    const version = response.headers.get("x-hypermedia-version");
-    const encodedTitle = response.headers.get("x-hypermedia-title");
-    const title = encodedTitle ? decodeURIComponent(encodedTitle) : null;
-    const rawTarget = response.headers.get("x-hypermedia-target");
-    const target = rawTarget ? unpackHmId(decodeURIComponent(rawTarget)) : null;
-    const rawAuthors = response.headers.get("x-hypermedia-authors");
-    const authors = rawAuthors ? decodeURIComponent(rawAuthors).split(",").map((author) => unpackHmId(author)) : null;
-    const type = response.headers.get("x-hypermedia-type");
-    if (id) {
-      const hmId = unpackHmId(id);
-      const resolvedVersion = version ?? (hmId == null ? void 0 : hmId.version) ?? null;
-      let siteHostname = null;
-      try {
-        const inputUrl = new URL(url);
-        if (!inputUrl.pathname.startsWith("/hm/")) {
-          siteHostname = inputUrl.origin;
-        }
-      } catch {
-      }
-      return {
-        id,
-        hmId: hmId ? {
-          ...hmId,
-          version: resolvedVersion,
-          latest,
-          blockRef,
-          blockRange,
-          hostname: siteHostname || hmId.hostname
-        } : null,
-        version,
-        title,
-        target,
-        authors,
-        type,
-        panel
-      };
-    }
-    return null;
-  }
-  return null;
-}
-async function resolveId(input) {
-  const parsed = unpackHmId(input);
-  if (parsed) return parsed;
-  if (input.startsWith("http://") || input.startsWith("https://")) {
-    const resolved = await resolveHypermediaUrl(input);
-    if (resolved == null ? void 0 : resolved.hmId) return resolved.hmId;
-    throw new Error(`URL does not appear to be a Seed Hypermedia resource: ${input}`);
-  }
-  throw new Error(`Invalid Hypermedia ID: ${input}`);
-}
 
 export {
   BlockRangeSchema,
@@ -1376,6 +1327,12 @@ export {
   HMListCommentVersionsInputSchema,
   HMListCommentVersionsOutputSchema,
   HMListCommentVersionsRequestSchema,
+  HMDomainInfoSchema,
+  HMGetDomainInputSchema,
+  HMGetDomainRequestSchema,
+  HMListDomainsInputSchema,
+  HMListDomainsOutputSchema,
+  HMListDomainsRequestSchema,
   HMGetRequestSchema,
   HMActionSchema,
   HMRequestSchema,
@@ -1390,7 +1347,5 @@ export {
   parseFragment,
   unpackHmId,
   codePointLength,
-  isSurrogate,
-  resolveHypermediaUrl,
-  resolveId
+  isSurrogate
 };

package/dist/hm-resolver.d.ts

@@ -0,0 +1,38 @@
+import { type UnpackedHypermediaId } from './hm-types';
+/**
+ * A domain resolver function that maps a hostname to an account UID
+ * using the daemon's domain store. Returns the UID if cached, or null.
+ */
+export type DomainResolverFn = (hostname: string) => Promise<string | null>;
+/**
+ * Callback fired when a background domain check detects that a domain
+ * now points to a different account UID than what was cached.
+ */
+export type DomainIdChangedCallback = (domain: string, oldUid: string, newUid: string) => void;
+export type ResolveOptions = {
+    domainResolver?: DomainResolverFn;
+};
+/**
+ * Resolve a web URL to its Hypermedia metadata.
+ *
+ * If opts.domainResolver is provided, it is tried first for fast cached
+ * resolution (works offline). Falls back to an OPTIONS request if the
+ * domain resolver returns null or is not provided.
+ */
+export type ResolvedUrl = {
+    id: string;
+    hmId: UnpackedHypermediaId;
+    version: string | null;
+    title: string | null;
+    target: UnpackedHypermediaId | null;
+    authors: UnpackedHypermediaId[] | null;
+    type: string | null;
+    panel: string | null;
+};
+export declare function resolveHypermediaUrl(url: string, opts?: ResolveOptions): Promise<ResolvedUrl | null>;
+/**
+ * Resolve a string that may be an hm:// ID, a gateway URL, or a site web URL
+ * into an UnpackedHypermediaId. Tries synchronous parsing first, then falls
+ * back to an OPTIONS request for web URLs.
+ */
+export declare function resolveId(input: string, opts?: ResolveOptions): Promise<UnpackedHypermediaId>;

package/dist/hm-types.d.ts

@@ -27283,6 +27283,244 @@ export declare const HMListCommentVersionsRequestSchema: z.ZodObject<{
     };
 }>;
 export type HMListCommentVersionsRequest = z.infer<typeof HMListCommentVersionsRequestSchema>;
+export declare const HMDomainInfoSchema: z.ZodObject<{
+    domain: z.ZodString;
+    lastCheck: z.ZodNullable<z.ZodDate>;
+    status: z.ZodString;
+    lastSuccess: z.ZodNullable<z.ZodDate>;
+    registeredAccountUid: z.ZodNullable<z.ZodString>;
+    peerId: z.ZodNullable<z.ZodString>;
+    lastError: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    peerId: string | null;
+    registeredAccountUid: string | null;
+    domain: string;
+    lastCheck: Date | null;
+    lastSuccess: Date | null;
+    lastError: string | null;
+}, {
+    status: string;
+    peerId: string | null;
+    registeredAccountUid: string | null;
+    domain: string;
+    lastCheck: Date | null;
+    lastSuccess: Date | null;
+    lastError: string | null;
+}>;
+export type HMDomainInfo = z.infer<typeof HMDomainInfoSchema>;
+export declare const HMGetDomainInputSchema: z.ZodObject<{
+    domain: z.ZodString;
+    /** If true, forces a fresh HTTP check instead of returning cached data. */
+    forceCheck: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    domain: string;
+    forceCheck?: boolean | undefined;
+}, {
+    domain: string;
+    forceCheck?: boolean | undefined;
+}>;
+export type HMGetDomainInput = z.infer<typeof HMGetDomainInputSchema>;
+export declare const HMGetDomainRequestSchema: z.ZodObject<{
+    key: z.ZodLiteral<"GetDomain">;
+    input: z.ZodObject<{
+        domain: z.ZodString;
+        /** If true, forces a fresh HTTP check instead of returning cached data. */
+        forceCheck: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        domain: string;
+        forceCheck?: boolean | undefined;
+    }, {
+        domain: string;
+        forceCheck?: boolean | undefined;
+    }>;
+    output: z.ZodObject<{
+        domain: z.ZodString;
+        lastCheck: z.ZodNullable<z.ZodDate>;
+        status: z.ZodString;
+        lastSuccess: z.ZodNullable<z.ZodDate>;
+        registeredAccountUid: z.ZodNullable<z.ZodString>;
+        peerId: z.ZodNullable<z.ZodString>;
+        lastError: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    }, {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    key: "GetDomain";
+    input: {
+        domain: string;
+        forceCheck?: boolean | undefined;
+    };
+    output: {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    };
+}, {
+    key: "GetDomain";
+    input: {
+        domain: string;
+        forceCheck?: boolean | undefined;
+    };
+    output: {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    };
+}>;
+export type HMGetDomainRequest = z.infer<typeof HMGetDomainRequestSchema>;
+export declare const HMListDomainsInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type HMListDomainsInput = z.infer<typeof HMListDomainsInputSchema>;
+export declare const HMListDomainsOutputSchema: z.ZodObject<{
+    domains: z.ZodArray<z.ZodObject<{
+        domain: z.ZodString;
+        lastCheck: z.ZodNullable<z.ZodDate>;
+        status: z.ZodString;
+        lastSuccess: z.ZodNullable<z.ZodDate>;
+        registeredAccountUid: z.ZodNullable<z.ZodString>;
+        peerId: z.ZodNullable<z.ZodString>;
+        lastError: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    }, {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    domains: {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    }[];
+}, {
+    domains: {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    }[];
+}>;
+export type HMListDomainsOutput = z.infer<typeof HMListDomainsOutputSchema>;
+export declare const HMListDomainsRequestSchema: z.ZodObject<{
+    key: z.ZodLiteral<"ListDomains">;
+    input: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    output: z.ZodObject<{
+        domains: z.ZodArray<z.ZodObject<{
+            domain: z.ZodString;
+            lastCheck: z.ZodNullable<z.ZodDate>;
+            status: z.ZodString;
+            lastSuccess: z.ZodNullable<z.ZodDate>;
+            registeredAccountUid: z.ZodNullable<z.ZodString>;
+            peerId: z.ZodNullable<z.ZodString>;
+            lastError: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }, {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        domains: {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }[];
+    }, {
+        domains: {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    key: "ListDomains";
+    input: {};
+    output: {
+        domains: {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }[];
+    };
+}, {
+    key: "ListDomains";
+    input: {};
+    output: {
+        domains: {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }[];
+    };
+}>;
+export type HMListDomainsRequest = z.infer<typeof HMListDomainsRequestSchema>;
 export declare const HMGetRequestSchema: z.ZodDiscriminatedUnion<"key", [z.ZodObject<{
     key: z.ZodLiteral<"Resource">;
     input: z.ZodObject<{
@@ -36373,6 +36611,152 @@ export declare const HMGetRequestSchema: z.ZodDiscriminatedUnion<"key", [z.ZodOb
             capability?: string | undefined;
         }[];
     };
+}>, z.ZodObject<{
+    key: z.ZodLiteral<"GetDomain">;
+    input: z.ZodObject<{
+        domain: z.ZodString;
+        /** If true, forces a fresh HTTP check instead of returning cached data. */
+        forceCheck: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        domain: string;
+        forceCheck?: boolean | undefined;
+    }, {
+        domain: string;
+        forceCheck?: boolean | undefined;
+    }>;
+    output: z.ZodObject<{
+        domain: z.ZodString;
+        lastCheck: z.ZodNullable<z.ZodDate>;
+        status: z.ZodString;
+        lastSuccess: z.ZodNullable<z.ZodDate>;
+        registeredAccountUid: z.ZodNullable<z.ZodString>;
+        peerId: z.ZodNullable<z.ZodString>;
+        lastError: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    }, {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    key: "GetDomain";
+    input: {
+        domain: string;
+        forceCheck?: boolean | undefined;
+    };
+    output: {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    };
+}, {
+    key: "GetDomain";
+    input: {
+        domain: string;
+        forceCheck?: boolean | undefined;
+    };
+    output: {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    };
+}>, z.ZodObject<{
+    key: z.ZodLiteral<"ListDomains">;
+    input: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    output: z.ZodObject<{
+        domains: z.ZodArray<z.ZodObject<{
+            domain: z.ZodString;
+            lastCheck: z.ZodNullable<z.ZodDate>;
+            status: z.ZodString;
+            lastSuccess: z.ZodNullable<z.ZodDate>;
+            registeredAccountUid: z.ZodNullable<z.ZodString>;
+            peerId: z.ZodNullable<z.ZodString>;
+            lastError: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }, {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        domains: {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }[];
+    }, {
+        domains: {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    key: "ListDomains";
+    input: {};
+    output: {
+        domains: {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }[];
+    };
+}, {
+    key: "ListDomains";
+    input: {};
+    output: {
+        domains: {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }[];
+    };
 }>]>;
 export type HMGetRequest = z.infer<typeof HMGetRequestSchema>;
 export declare const HMActionSchema: z.ZodDiscriminatedUnion<"key", [z.ZodObject<{
@@ -46235,6 +46619,152 @@ export declare const HMRequestSchema: z.ZodDiscriminatedUnion<"key", [z.ZodObjec
             capability?: string | undefined;
         }[];
     };
+}>, z.ZodObject<{
+    key: z.ZodLiteral<"GetDomain">;
+    input: z.ZodObject<{
+        domain: z.ZodString;
+        /** If true, forces a fresh HTTP check instead of returning cached data. */
+        forceCheck: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        domain: string;
+        forceCheck?: boolean | undefined;
+    }, {
+        domain: string;
+        forceCheck?: boolean | undefined;
+    }>;
+    output: z.ZodObject<{
+        domain: z.ZodString;
+        lastCheck: z.ZodNullable<z.ZodDate>;
+        status: z.ZodString;
+        lastSuccess: z.ZodNullable<z.ZodDate>;
+        registeredAccountUid: z.ZodNullable<z.ZodString>;
+        peerId: z.ZodNullable<z.ZodString>;
+        lastError: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    }, {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    key: "GetDomain";
+    input: {
+        domain: string;
+        forceCheck?: boolean | undefined;
+    };
+    output: {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    };
+}, {
+    key: "GetDomain";
+    input: {
+        domain: string;
+        forceCheck?: boolean | undefined;
+    };
+    output: {
+        status: string;
+        peerId: string | null;
+        registeredAccountUid: string | null;
+        domain: string;
+        lastCheck: Date | null;
+        lastSuccess: Date | null;
+        lastError: string | null;
+    };
+}>, z.ZodObject<{
+    key: z.ZodLiteral<"ListDomains">;
+    input: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    output: z.ZodObject<{
+        domains: z.ZodArray<z.ZodObject<{
+            domain: z.ZodString;
+            lastCheck: z.ZodNullable<z.ZodDate>;
+            status: z.ZodString;
+            lastSuccess: z.ZodNullable<z.ZodDate>;
+            registeredAccountUid: z.ZodNullable<z.ZodString>;
+            peerId: z.ZodNullable<z.ZodString>;
+            lastError: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }, {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        domains: {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }[];
+    }, {
+        domains: {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    key: "ListDomains";
+    input: {};
+    output: {
+        domains: {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }[];
+    };
+}, {
+    key: "ListDomains";
+    input: {};
+    output: {
+        domains: {
+            status: string;
+            peerId: string | null;
+            registeredAccountUid: string | null;
+            domain: string;
+            lastCheck: Date | null;
+            lastSuccess: Date | null;
+            lastError: string | null;
+        }[];
+    };
 }>, z.ZodObject<{
     key: z.ZodLiteral<"PublishBlobs">;
     input: z.ZodObject<{
@@ -47033,70 +47563,4 @@ export declare function unpackHmId(hypermediaId?: string): UnpackedHypermediaId
 export declare function codePointLength(entry: string): number;
 /** Check if a UTF-16 code unit at index i is the start of a surrogate pair. */
 export declare function isSurrogate(s: string, i: number): boolean;
-/** Resolve a web URL to its Hypermedia metadata via an OPTIONS request. */
-export declare function resolveHypermediaUrl(url: string): Promise<{
-    id: string;
-    hmId: {
-        version: string | null;
-        latest: boolean;
-        blockRef: string | null;
-        blockRange: {
-            start: number;
-            end: number;
-        } | {
-            expanded: boolean;
-        } | null;
-        hostname: string | null;
-        path: string[] | null;
-        id: string;
-        uid: string;
-        scheme: string | null;
-        targetDocUid?: string | null | undefined;
-        targetDocPath?: string[] | null | undefined;
-    } | null;
-    version: string | null;
-    title: string | null;
-    target: {
-        path: string[] | null;
-        version: string | null;
-        id: string;
-        uid: string;
-        blockRef: string | null;
-        blockRange: {
-            start?: number | undefined;
-            end?: number | undefined;
-            expanded?: boolean | undefined;
-        } | null;
-        hostname: string | null;
-        scheme: string | null;
-        latest?: boolean | null | undefined;
-        targetDocUid?: string | null | undefined;
-        targetDocPath?: string[] | null | undefined;
-    } | null;
-    authors: ({
-        path: string[] | null;
-        version: string | null;
-        id: string;
-        uid: string;
-        blockRef: string | null;
-        blockRange: {
-            start?: number | undefined;
-            end?: number | undefined;
-            expanded?: boolean | undefined;
-        } | null;
-        hostname: string | null;
-        scheme: string | null;
-        latest?: boolean | null | undefined;
-        targetDocUid?: string | null | undefined;
-        targetDocPath?: string[] | null | undefined;
-    } | null)[] | null;
-    type: string | null;
-    panel: string | null;
-} | null>;
-/**
- * Resolve a string that may be an hm:// ID, a gateway URL, or a site web URL
- * into an UnpackedHypermediaId. Tries synchronous parsing first, then falls
- * back to an OPTIONS request for web URLs.
- */
-export declare function resolveId(input: string): Promise<UnpackedHypermediaId>;
 export {};

package/dist/hm-types.mjs

@@ -47,6 +47,7 @@ import {
   HMDocumentInfoSchema,
   HMDocumentMetadataSchema,
   HMDocumentSchema,
+  HMDomainInfoSchema,
   HMDraftContentSchema,
   HMDraftMetaSchema,
   HMEmbedViewSchema,
@@ -57,6 +58,8 @@ import {
   HMGetCIDRequestSchema,
   HMGetCommentReplyCountInputSchema,
   HMGetCommentReplyCountRequestSchema,
+  HMGetDomainInputSchema,
+  HMGetDomainRequestSchema,
   HMGetRequestSchema,
   HMHostConfigSchema,
   HMInteractionSummaryInputSchema,
@@ -88,6 +91,9 @@ import {
   HMListDiscussionsInputSchema,
   HMListDiscussionsOutputSchema,
   HMListDiscussionsRequestSchema,
+  HMListDomainsInputSchema,
+  HMListDomainsOutputSchema,
+  HMListDomainsRequestSchema,
   HMListEventsInputSchema,
   HMListEventsOutputSchema,
   HMListEventsRequestSchema,
@@ -154,14 +160,12 @@ import {
   packHmId,
   parseCustomURL,
   parseFragment,
-  resolveHypermediaUrl,
-  resolveId,
   serializeBlockRange,
   siteDiscoverRequestSchema,
   toNumber,
   unpackHmId,
   unpackedHmIdSchema
-} from "./chunk-LCXR7GLM.mjs";
+} from "./chunk-B6GAAJII.mjs";
 export {
   BlockRangeSchema,
   BoldAnnotationSchema,
@@ -211,6 +215,7 @@ export {
   HMDocumentInfoSchema,
   HMDocumentMetadataSchema,
   HMDocumentSchema,
+  HMDomainInfoSchema,
   HMDraftContentSchema,
   HMDraftMetaSchema,
   HMEmbedViewSchema,
@@ -221,6 +226,8 @@ export {
   HMGetCIDRequestSchema,
   HMGetCommentReplyCountInputSchema,
   HMGetCommentReplyCountRequestSchema,
+  HMGetDomainInputSchema,
+  HMGetDomainRequestSchema,
   HMGetRequestSchema,
   HMHostConfigSchema,
   HMInteractionSummaryInputSchema,
@@ -252,6 +259,9 @@ export {
   HMListDiscussionsInputSchema,
   HMListDiscussionsOutputSchema,
   HMListDiscussionsRequestSchema,
+  HMListDomainsInputSchema,
+  HMListDomainsOutputSchema,
+  HMListDomainsRequestSchema,
   HMListEventsInputSchema,
   HMListEventsOutputSchema,
   HMListEventsRequestSchema,
@@ -318,8 +328,6 @@ export {
   packHmId,
   parseCustomURL,
   parseFragment,
-  resolveHypermediaUrl,
-  resolveId,
   serializeBlockRange,
   siteDiscoverRequestSchema,
   toNumber,

package/dist/index.d.ts

@@ -20,8 +20,10 @@ export type { GrobidOptions } from './grobid';
 export { embeddedPdfToBlocks } from './pdf-to-blocks-embedded';
 export type { EmbeddedPdfResult } from './pdf-to-blocks-embedded';
 export { trimTrailingEmptyBlocks } from './comment';
-export { codePointLength, entityQueryPathToHmIdPath, getHMQueryString, hmIdPathToEntityQueryPath, HYPERMEDIA_SCHEME, isSurrogate, packBaseId, packHmId, parseCustomURL, parseFragment, resolveHypermediaUrl, resolveId, serializeBlockRange, unpackHmId, } from './hm-types';
+export { codePointLength, entityQueryPathToHmIdPath, getHMQueryString, hmIdPathToEntityQueryPath, HYPERMEDIA_SCHEME, isSurrogate, packBaseId, packHmId, parseCustomURL, parseFragment, serializeBlockRange, unpackHmId, } from './hm-types';
 export type { HMRequest, HMSigner, UnpackedHypermediaId } from './hm-types';
+export { resolveHypermediaUrl, resolveId } from './hm-resolver';
+export type { DomainResolverFn, DomainIdChangedCallback, ResolveOptions, ResolvedUrl } from './hm-resolver';
 export { fileToIpfsBlobs, filesToIpfsBlobs, resolveFileLinksInBlocks, hasFileLinks } from './file-to-ipfs';
 export type { CollectedBlob } from './file-to-ipfs';
 export { parseMarkdown, flattenToOperations, parseInlineFormatting, parseFrontmatter, markdownBlockNodesToHMBlockNodes, } from './markdown-to-blocks';

package/dist/index.mjs

@@ -13,12 +13,10 @@ import {
   packHmId,
   parseCustomURL,
   parseFragment,
-  resolveHypermediaUrl,
-  resolveId,
   serializeBlockRange,
   toNumber,
   unpackHmId
-} from "./chunk-LCXR7GLM.mjs";
+} from "./chunk-B6GAAJII.mjs";
 
 // src/capability.ts
 import { encode as cborEncode2 } from "@ipld/dag-cbor";
@@ -2006,6 +2004,130 @@ async function useEmbeddedExtraction(pdfData) {
   };
 }
 
+// src/hm-resolver.ts
+async function resolveHypermediaUrl(url, opts) {
+  let latest = false;
+  let blockRef = null;
+  let blockRange = null;
+  let panel = null;
+  let parsedHostname = null;
+  try {
+    const parsedUrl = new URL(url);
+    parsedHostname = parsedUrl.hostname;
+    const hasVersion = parsedUrl.searchParams.has("v");
+    const hasLatest = parsedUrl.searchParams.has("l");
+    panel = parsedUrl.searchParams.get("panel");
+    if (parsedUrl.hash) {
+      const fragment = parseFragment(parsedUrl.hash.slice(1));
+      if (fragment) {
+        blockRef = fragment.blockId;
+        if ("start" in fragment && fragment.start !== void 0) {
+          blockRange = { start: fragment.start, end: fragment.end };
+        } else if ("expanded" in fragment && fragment.expanded) {
+          blockRange = { expanded: fragment.expanded };
+        }
+      }
+    }
+    latest = blockRef ? false : hasLatest || !hasVersion;
+  } catch {
+  }
+  if ((opts == null ? void 0 : opts.domainResolver) && parsedHostname) {
+    try {
+      const parsedUrl = new URL(url);
+      const uid = await opts.domainResolver(parsedHostname);
+      if (uid) {
+        const pathSegments = parsedUrl.pathname.split("/").filter(Boolean);
+        const path = pathSegments.length > 0 ? pathSegments : null;
+        const version = parsedUrl.searchParams.get("v") || null;
+        const pathStr = path ? "/" + path.join("/") : "";
+        const siteHostname = parsedUrl.origin;
+        return {
+          id: `hm://${uid}${pathStr}`,
+          hmId: {
+            id: `hm://${uid}${pathStr}`,
+            uid,
+            path,
+            version,
+            blockRef,
+            blockRange,
+            hostname: siteHostname,
+            scheme: "hm",
+            latest
+          },
+          version,
+          title: null,
+          target: null,
+          authors: null,
+          type: null,
+          panel
+        };
+      }
+    } catch {
+    }
+  }
+  const response = await fetch(url, {
+    method: "OPTIONS"
+  });
+  if (response.status === 200) {
+    const rawId = response.headers.get("x-hypermedia-id");
+    const id = rawId ? decodeURIComponent(rawId) : null;
+    const version = response.headers.get("x-hypermedia-version");
+    const encodedTitle = response.headers.get("x-hypermedia-title");
+    const title = encodedTitle ? decodeURIComponent(encodedTitle) : null;
+    const rawTarget = response.headers.get("x-hypermedia-target");
+    const target = rawTarget ? unpackHmId(decodeURIComponent(rawTarget)) : null;
+    const rawAuthors = response.headers.get("x-hypermedia-authors");
+    const authors = rawAuthors ? decodeURIComponent(rawAuthors).split(",").map((author) => unpackHmId(author)).filter((author) => author !== null) : null;
+    const type = response.headers.get("x-hypermedia-type");
+    if (id) {
+      const hmId = unpackHmId(id);
+      const resolvedVersion = version ?? (hmId == null ? void 0 : hmId.version) ?? null;
+      let siteHostname = null;
+      try {
+        const inputUrl = new URL(url);
+        if (!inputUrl.pathname.startsWith("/hm/")) {
+          siteHostname = inputUrl.origin;
+        }
+      } catch {
+      }
+      if (!hmId) {
+        return null;
+      }
+      return {
+        id,
+        hmId: {
+          ...hmId,
+          version: resolvedVersion,
+          latest,
+          blockRef,
+          blockRange,
+          hostname: siteHostname || hmId.hostname
+        },
+        version,
+        title,
+        target,
+        authors,
+        type,
+        panel
+      };
+    }
+    return null;
+  }
+  return null;
+}
+async function resolveId(input, opts) {
+  const parsed = unpackHmId(input);
+  if (parsed) return parsed;
+  if (input.startsWith("http://") || input.startsWith("https://")) {
+    const resolved = await resolveHypermediaUrl(input, opts);
+    if (resolved == null ? void 0 : resolved.hmId) return resolved.hmId;
+    throw new Error(
+      `URL does not appear to be a Seed Hypermedia resource: ${input}`
+    );
+  }
+  throw new Error(`Invalid Hypermedia ID: ${input}`);
+}
+
 // src/file-to-ipfs.ts
 import { MemoryBlockstore } from "blockstore-core/memory";
 import { importer as unixFSImporter } from "ipfs-unixfs-importer";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seed-hypermedia/client",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "repository": {
     "type": "git",
     "url": "https://github.com/seed-hypermedia/seed",

package/src/index.ts

@@ -46,13 +46,14 @@ export {
   packHmId,
   parseCustomURL,
   parseFragment,
-  resolveHypermediaUrl,
-  resolveId,
   serializeBlockRange,
   unpackHmId,
 } from './hm-types'
 export type {HMRequest, HMSigner, UnpackedHypermediaId} from './hm-types'
 
+export {resolveHypermediaUrl, resolveId} from './hm-resolver'
+export type {DomainResolverFn, DomainIdChangedCallback, ResolveOptions, ResolvedUrl} from './hm-resolver'
+
 export {fileToIpfsBlobs, filesToIpfsBlobs, resolveFileLinksInBlocks, hasFileLinks} from './file-to-ipfs'
 export type {CollectedBlob} from './file-to-ipfs'