@singi-labs/sifa-sdk 0.9.12 → 0.9.14

package/dist/publishing/index.d.ts

@@ -0,0 +1,253 @@
+import { z } from 'zod';
+
+/**
+ * Zod schemas mirroring the canonical Standard.site lexicons that Sifa
+ * consumes when rendering publication embeds.
+ *
+ * Canonical lexicons live at:
+ *   DID:        did:plc:re3ebnp5v7ffagz6rb6xfei4
+ *   PDS:        https://auriporia.us-west.host.bsky.network
+ *   Collection: com.atproto.lexicon.schema
+ *
+ * Sifa does NOT own these lexicons; we vendor the validation shapes so
+ * clients can parse augmented embeds and (in Phase 4) write subscription
+ * records to viewers' PDSes. Re-check against the canonical PDS on each
+ * SDK release to detect schema drift.
+ */
+declare const rgbColorSchema: z.ZodObject<{
+    r: z.ZodNumber;
+    g: z.ZodNumber;
+    b: z.ZodNumber;
+}, z.core.$strip>;
+type RgbColor = z.infer<typeof rgbColorSchema>;
+/** site.standard.theme.basic */
+declare const BasicThemeSchema: z.ZodObject<{
+    background: z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+    }, z.core.$strip>;
+    foreground: z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+    }, z.core.$strip>;
+    accent: z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+    }, z.core.$strip>;
+    accentForeground: z.ZodObject<{
+        r: z.ZodNumber;
+        g: z.ZodNumber;
+        b: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type BasicTheme = z.infer<typeof BasicThemeSchema>;
+/** site.standard.publication */
+declare const StandardSitePublicationRecordSchema: z.ZodObject<{
+    url: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodObject<{
+        $type: z.ZodOptional<z.ZodString>;
+        ref: z.ZodUnknown;
+        mimeType: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    basicTheme: z.ZodOptional<z.ZodObject<{
+        background: z.ZodObject<{
+            r: z.ZodNumber;
+            g: z.ZodNumber;
+            b: z.ZodNumber;
+        }, z.core.$strip>;
+        foreground: z.ZodObject<{
+            r: z.ZodNumber;
+            g: z.ZodNumber;
+            b: z.ZodNumber;
+        }, z.core.$strip>;
+        accent: z.ZodObject<{
+            r: z.ZodNumber;
+            g: z.ZodNumber;
+            b: z.ZodNumber;
+        }, z.core.$strip>;
+        accentForeground: z.ZodObject<{
+            r: z.ZodNumber;
+            g: z.ZodNumber;
+            b: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    labels: z.ZodOptional<z.ZodObject<{
+        $type: z.ZodOptional<z.ZodLiteral<"com.atproto.label.defs#selfLabels">>;
+        values: z.ZodArray<z.ZodObject<{
+            val: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    preferences: z.ZodOptional<z.ZodObject<{
+        showInDiscover: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+type StandardSitePublicationRecord = z.infer<typeof StandardSitePublicationRecordSchema>;
+/** site.standard.document */
+declare const StandardSiteDocumentRecordSchema: z.ZodObject<{
+    site: z.ZodString;
+    title: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    publishedAt: z.ZodString;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    textContent: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    coverImage: z.ZodOptional<z.ZodObject<{
+        $type: z.ZodOptional<z.ZodString>;
+        ref: z.ZodUnknown;
+        mimeType: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    contributors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        did: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        displayName: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    bskyPostRef: z.ZodOptional<z.ZodObject<{
+        uri: z.ZodString;
+        cid: z.ZodString;
+    }, z.core.$strip>>;
+    labels: z.ZodOptional<z.ZodObject<{
+        $type: z.ZodOptional<z.ZodLiteral<"com.atproto.label.defs#selfLabels">>;
+        values: z.ZodArray<z.ZodObject<{
+            val: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+type StandardSiteDocumentRecord = z.infer<typeof StandardSiteDocumentRecordSchema>;
+/**
+ * site.standard.graph.subscription
+ *
+ * Authored by a viewer to declare a subscription to a publication. Used
+ * by Phase 4 inline-subscribe path. Record key is a TID; the AT-URI
+ * shape is `at://<viewer-did>/site.standard.graph.subscription/<rkey>`.
+ */
+declare const StandardSiteSubscriptionRecordSchema: z.ZodObject<{
+    publication: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type StandardSiteSubscriptionRecord = z.infer<typeof StandardSiteSubscriptionRecordSchema>;
+/**
+ * site.standard.graph.recommend
+ *
+ * Document-level "like" record. Same scope as subscription via the
+ * site.standard.authSocial OAuth permission-set, so Phase 4 unlocks
+ * inline likes alongside inline subscribes.
+ */
+declare const StandardSiteRecommendRecordSchema: z.ZodObject<{
+    document: z.ZodString;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type StandardSiteRecommendRecord = z.infer<typeof StandardSiteRecommendRecordSchema>;
+
+/**
+ * Publisher allowlist for the Standard.site rich embed.
+ *
+ * Mirrors `bluesky-social/social-app`
+ * `src/components/Post/Embed/StandardSiteEmbed/publishers.ts`. The only
+ * gate this provides is which publishers get the highlighted
+ * "Subscribe on {Publisher}" CTA with a publisher icon vs the plain
+ * "View publication" fallback — any Standard.site embed renders
+ * regardless of allowlist membership.
+ *
+ * Sync policy: review additions against the upstream bsky list weekly;
+ * Singi Labs reviews before merge.
+ */
+interface Publisher {
+    /** Lowercase host. Subdomains are matched via `hostMatches`. */
+    host: string;
+    /** Human-facing publisher name shown in CTA copy. */
+    name: string;
+    /**
+     * Stable identifier used by clients to look up brand icons. The SDK
+     * does not ship icon assets — sifa-web maintains them keyed by this
+     * id so React Native vs web rendering can diverge.
+     */
+    iconKey: 'leaflet' | 'pckt' | 'offprint';
+}
+declare const STANDARD_SITE_PUBLISHERS: readonly Publisher[];
+/**
+ * Returns true when `host` exactly matches `target` or is a subdomain of
+ * it. Hosts are expected to be lowercase already.
+ */
+declare function hostMatches(host: string, target: string): boolean;
+/**
+ * Match a publisher by host. Returns the publisher when `host` is on the
+ * allowlist (exact or subdomain match), null otherwise. Host should be
+ * lowercase.
+ */
+declare function matchPublisherByHost(host: string | null | undefined): Publisher | null;
+/**
+ * Match a publisher by URI. Convenience wrapper around
+ * `matchPublisherByHost` for callers that have a publication URL handy.
+ */
+declare function matchPublisherByUri(uri: string | undefined | null): Publisher | null;
+
+/**
+ * Publication metadata embedded in the augmented activity view by
+ * sifa-api when an external link card matches an indexed publication.
+ *
+ * `uri` is the publication's AT-URI (e.g.
+ * `at://did:plc:abc/site.standard.publication/xyz`). `theme` carries
+ * the publication's own colors when supplied — clients should apply a
+ * WCAG min-contrast fallback before honoring them.
+ *
+ * `icon` is left as `unknown` here because its representation depends
+ * on the surface: blob ref on the wire, CDN URL after resolution.
+ */
+interface PublicationSource {
+    uri: string;
+    title: string;
+    icon?: unknown;
+    theme?: BasicTheme;
+}
+/**
+ * Shape attached to activity items whose external link card URL matches
+ * a Standard.site record. Mirrors the relevant fields of bsky's
+ * `StandardSiteEmbed` view so a sifa-web renderer can be near-1:1.
+ *
+ * `associatedRefs` carries AT-URIs the client may use in Phase 4 to
+ * query subscription state for the viewer.
+ */
+interface StandardSiteEmbedView {
+    uri: string;
+    source: PublicationSource;
+    associatedRefs: {
+        uri: string;
+    }[];
+    createdAt?: string;
+    readingTime?: number;
+}
+declare const STANDARD_SITE_PUBLICATION_NSID: "site.standard.publication";
+declare const STANDARD_SITE_DOCUMENT_NSID: "site.standard.document";
+declare const STANDARD_SITE_SUBSCRIPTION_NSID: "site.standard.graph.subscription";
+declare const STANDARD_SITE_RECOMMEND_NSID: "site.standard.graph.recommend";
+/**
+ * Pre-defined OAuth permission-set the consumer apps request to write
+ * subscription + recommend records on behalf of the viewer. The actual
+ * permission-set is published under
+ * `at://did:plc:re3ebnp5v7ffagz6rb6xfei4/com.atproto.lexicon.schema/site.standard.authSocial`.
+ */
+declare const STANDARD_SITE_AUTH_SOCIAL_NSID: "site.standard.authSocial";
+/**
+ * True when the AT-URI's collection segment is a Standard.site
+ * collection. Useful for detecting Standard.site embed augmentation on
+ * arbitrary activity items.
+ */
+declare function isStandardSiteAtUri(uri: string): boolean;
+/**
+ * True when any `associatedRefs[].uri` is a Standard.site collection
+ * AT-URI. The bsky client uses the same check to gate the
+ * `StandardSiteEmbed` renderer.
+ */
+declare function hasStandardSiteAssociatedRef(refs: {
+    uri: string;
+}[] | undefined): boolean;
+
+export { type BasicTheme, BasicThemeSchema, type PublicationSource, type Publisher, type RgbColor, STANDARD_SITE_AUTH_SOCIAL_NSID, STANDARD_SITE_DOCUMENT_NSID, STANDARD_SITE_PUBLICATION_NSID, STANDARD_SITE_PUBLISHERS, STANDARD_SITE_RECOMMEND_NSID, STANDARD_SITE_SUBSCRIPTION_NSID, type StandardSiteDocumentRecord, StandardSiteDocumentRecordSchema, type StandardSiteEmbedView, type StandardSitePublicationRecord, StandardSitePublicationRecordSchema, type StandardSiteRecommendRecord, StandardSiteRecommendRecordSchema, type StandardSiteSubscriptionRecord, StandardSiteSubscriptionRecordSchema, hasStandardSiteAssociatedRef, hostMatches, isStandardSiteAtUri, matchPublisherByHost, matchPublisherByUri };

package/dist/publishing/index.js

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+
+// src/publishing/schemas.ts
+function maxGraphemes(max) {
+  return (value) => {
+    const segmenter = new Intl.Segmenter(void 0, { granularity: "grapheme" });
+    let count = 0;
+    for (const _ of segmenter.segment(value)) {
+      count++;
+      if (count > max) return false;
+    }
+    return true;
+  };
+}
+var didSchema = z.string().regex(/^did:[a-z]+:[a-zA-Z0-9._:%-]+$/, "Invalid DID");
+var datetimeSchema = z.string().datetime({ offset: true });
+var atUriSchema = z.string().regex(/^at:\/\/[^\s]+$/, "Invalid AT-URI");
+var cidSchema = z.string().regex(/^(Qm[1-9A-HJ-NP-Za-km-z]{44}|b[A-Za-z0-9+/=]+)$/, "Invalid CID");
+z.string().regex(/^[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*$/, "Invalid BCP 47 language tag");
+var uriSchema = z.string().url();
+var strongRefSchema = z.object({
+  uri: atUriSchema,
+  cid: cidSchema
+});
+var selfLabelsSchema = z.object({
+  $type: z.literal("com.atproto.label.defs#selfLabels").optional(),
+  values: z.array(z.object({ val: z.string() }))
+});
+
+// src/publishing/schemas.ts
+var rgbColorSchema = z.object({
+  r: z.number().int().min(0).max(255),
+  g: z.number().int().min(0).max(255),
+  b: z.number().int().min(0).max(255)
+});
+var BasicThemeSchema = z.object({
+  background: rgbColorSchema,
+  foreground: rgbColorSchema,
+  accent: rgbColorSchema,
+  accentForeground: rgbColorSchema
+});
+var blobRefSchema = z.object({
+  $type: z.string().optional(),
+  ref: z.unknown(),
+  mimeType: z.string().optional(),
+  size: z.number().optional()
+}).passthrough();
+var StandardSitePublicationRecordSchema = z.object({
+  url: uriSchema,
+  name: z.string().min(1).refine(maxGraphemes(500)).max(5e3),
+  description: z.string().refine(maxGraphemes(3e3)).max(3e4).optional(),
+  icon: blobRefSchema.optional(),
+  basicTheme: BasicThemeSchema.optional(),
+  labels: selfLabelsSchema.optional(),
+  preferences: z.object({
+    showInDiscover: z.boolean().optional()
+  }).partial().optional()
+}).passthrough();
+var contributorSchema = z.object({
+  did: didSchema,
+  role: z.string().refine(maxGraphemes(100)).max(1e3).optional(),
+  displayName: z.string().refine(maxGraphemes(100)).max(1e3).optional()
+}).passthrough();
+var StandardSiteDocumentRecordSchema = z.object({
+  site: z.string().min(1),
+  title: z.string().min(1).refine(maxGraphemes(500)).max(5e3),
+  path: z.string().optional(),
+  publishedAt: datetimeSchema,
+  updatedAt: datetimeSchema.optional(),
+  description: z.string().refine(maxGraphemes(3e3)).max(3e4).optional(),
+  textContent: z.string().optional(),
+  tags: z.array(z.string().refine(maxGraphemes(128)).max(1280)).optional(),
+  coverImage: blobRefSchema.optional(),
+  contributors: z.array(contributorSchema).optional(),
+  bskyPostRef: strongRefSchema.optional(),
+  labels: selfLabelsSchema.optional()
+}).passthrough();
+var StandardSiteSubscriptionRecordSchema = z.object({
+  publication: atUriSchema,
+  createdAt: datetimeSchema.optional()
+});
+var StandardSiteRecommendRecordSchema = z.object({
+  document: atUriSchema,
+  createdAt: datetimeSchema
+});
+
+// src/publishing/registry.ts
+var STANDARD_SITE_PUBLISHERS = Object.freeze([
+  { host: "leaflet.pub", name: "Leaflet", iconKey: "leaflet" },
+  { host: "pckt.blog", name: "pckt", iconKey: "pckt" },
+  { host: "offprint.app", name: "Offprint", iconKey: "offprint" }
+]);
+function hostMatches(host, target) {
+  return host === target || host.endsWith("." + target);
+}
+function hostFromUri(uri) {
+  if (!uri) return null;
+  try {
+    return new URL(uri).host.toLowerCase();
+  } catch {
+    return null;
+  }
+}
+function matchPublisherByHost(host) {
+  if (!host) return null;
+  const lower = host.toLowerCase();
+  return STANDARD_SITE_PUBLISHERS.find((p) => hostMatches(lower, p.host)) ?? null;
+}
+function matchPublisherByUri(uri) {
+  return matchPublisherByHost(hostFromUri(uri));
+}
+
+// src/publishing/types.ts
+var STANDARD_SITE_PUBLICATION_NSID = "site.standard.publication";
+var STANDARD_SITE_DOCUMENT_NSID = "site.standard.document";
+var STANDARD_SITE_SUBSCRIPTION_NSID = "site.standard.graph.subscription";
+var STANDARD_SITE_RECOMMEND_NSID = "site.standard.graph.recommend";
+var STANDARD_SITE_AUTH_SOCIAL_NSID = "site.standard.authSocial";
+var COLLECTION_SET = /* @__PURE__ */ new Set([
+  STANDARD_SITE_PUBLICATION_NSID,
+  STANDARD_SITE_DOCUMENT_NSID,
+  STANDARD_SITE_SUBSCRIPTION_NSID,
+  STANDARD_SITE_RECOMMEND_NSID
+]);
+function isStandardSiteAtUri(uri) {
+  if (!uri.startsWith("at://")) return false;
+  const segments = uri.slice("at://".length).split("/");
+  const collection = segments[1];
+  return collection !== void 0 && COLLECTION_SET.has(collection);
+}
+function hasStandardSiteAssociatedRef(refs) {
+  if (!refs) return false;
+  return refs.some((r) => isStandardSiteAtUri(r.uri));
+}
+
+export { BasicThemeSchema, STANDARD_SITE_AUTH_SOCIAL_NSID, STANDARD_SITE_DOCUMENT_NSID, STANDARD_SITE_PUBLICATION_NSID, STANDARD_SITE_PUBLISHERS, STANDARD_SITE_RECOMMEND_NSID, STANDARD_SITE_SUBSCRIPTION_NSID, StandardSiteDocumentRecordSchema, StandardSitePublicationRecordSchema, StandardSiteRecommendRecordSchema, StandardSiteSubscriptionRecordSchema, hasStandardSiteAssociatedRef, hostMatches, isStandardSiteAtUri, matchPublisherByHost, matchPublisherByUri };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/publishing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/schemas/shared.ts","../../src/publishing/schemas.ts","../../src/publishing/registry.ts","../../src/publishing/types.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["import { z } from 'zod';\n\n/**\n * Grapheme-aware refinement matching the AT Protocol lexicon `maxGraphemes`\n * constraint. JS strings are sequences of UTF-16 code units, but lexicon\n * `maxGraphemes` counts user-perceived characters (grapheme clusters), so\n * emoji sequences, regional indicators, ZWJ joins, and combining marks all\n * count as one unit each. We use `Intl.Segmenter` to enforce this correctly.\n */\nexport function maxGraphemes(max: number) {\n  return (value: string): boolean => {\n    const segmenter = new Intl.Segmenter(undefined, { granularity: 'grapheme' });\n    let count = 0;\n    for (const _ of segmenter.segment(value)) {\n      count++;\n      if (count > max) return false;\n    }\n    return true;\n  };\n}\n\n/** Decentralized identifier, AT Protocol `format: did`. */\nexport const didSchema = z.string().regex(/^did:[a-z]+:[a-zA-Z0-9._:%-]+$/, 'Invalid DID');\n\n/** RFC 3339 datetime with timezone offset, AT Protocol `format: datetime`. */\nexport const datetimeSchema = z.string().datetime({ offset: true });\n\n/** Generic AT-URI, AT Protocol `format: at-uri`. */\nexport const atUriSchema = z.string().regex(/^at:\\/\\/[^\\s]+$/, 'Invalid AT-URI');\n\n/** Content identifier, AT Protocol `format: cid`. Loose validation -- accepts CIDv0 and CIDv1. */\nexport const cidSchema = z\n  .string()\n  .regex(/^(Qm[1-9A-HJ-NP-Za-km-z]{44}|b[A-Za-z0-9+/=]+)$/, 'Invalid CID');\n\n/** BCP 47 language tag, AT Protocol `format: language`. */\nexport const languageTagSchema = z\n  .string()\n  .regex(/^[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*$/, 'Invalid BCP 47 language tag');\n\n/** Generic URI, AT Protocol `format: uri`. */\nexport const uriSchema = z.string().url();\n\n/**\n * StrongRef shape from `com.atproto.repo.strongRef` -- pins a record by both\n * AT-URI (identity) and CID (version).\n */\nexport const strongRefSchema = z.object({\n  uri: atUriSchema,\n  cid: cidSchema,\n});\n\n/**\n * Self-labels shape from `com.atproto.label.defs#selfLabels`. Modelled\n * permissively because clients rarely construct this directly; the AppView\n * handles label validation.\n */\nexport const selfLabelsSchema = z.object({\n  $type: z.literal('com.atproto.label.defs#selfLabels').optional(),\n  values: z.array(z.object({ val: z.string() })),\n});\n","import { z } from 'zod';\n\nimport {\n  atUriSchema,\n  datetimeSchema,\n  didSchema,\n  maxGraphemes,\n  selfLabelsSchema,\n  strongRefSchema,\n  uriSchema,\n} from '../schemas/shared.js';\n\n/**\n * Zod schemas mirroring the canonical Standard.site lexicons that Sifa\n * consumes when rendering publication embeds.\n *\n * Canonical lexicons live at:\n *   DID:        did:plc:re3ebnp5v7ffagz6rb6xfei4\n *   PDS:        https://auriporia.us-west.host.bsky.network\n *   Collection: com.atproto.lexicon.schema\n *\n * Sifa does NOT own these lexicons; we vendor the validation shapes so\n * clients can parse augmented embeds and (in Phase 4) write subscription\n * records to viewers' PDSes. Re-check against the canonical PDS on each\n * SDK release to detect schema drift.\n */\n\nconst rgbColorSchema = z.object({\n  r: z.number().int().min(0).max(255),\n  g: z.number().int().min(0).max(255),\n  b: z.number().int().min(0).max(255),\n});\n\nexport type RgbColor = z.infer<typeof rgbColorSchema>;\n\n/** site.standard.theme.basic */\nexport const BasicThemeSchema = z.object({\n  background: rgbColorSchema,\n  foreground: rgbColorSchema,\n  accent: rgbColorSchema,\n  accentForeground: rgbColorSchema,\n});\n\nexport type BasicTheme = z.infer<typeof BasicThemeSchema>;\n\nconst blobRefSchema = z\n  .object({\n    $type: z.string().optional(),\n    ref: z.unknown(),\n    mimeType: z.string().optional(),\n    size: z.number().optional(),\n  })\n  .passthrough();\n\n/** site.standard.publication */\nexport const StandardSitePublicationRecordSchema = z\n  .object({\n    url: uriSchema,\n    name: z.string().min(1).refine(maxGraphemes(500)).max(5000),\n    description: z.string().refine(maxGraphemes(3000)).max(30000).optional(),\n    icon: blobRefSchema.optional(),\n    basicTheme: BasicThemeSchema.optional(),\n    labels: selfLabelsSchema.optional(),\n    preferences: z\n      .object({\n        showInDiscover: z.boolean().optional(),\n      })\n      .partial()\n      .optional(),\n  })\n  .passthrough();\n\nexport type StandardSitePublicationRecord = z.infer<typeof StandardSitePublicationRecordSchema>;\n\nconst contributorSchema = z\n  .object({\n    did: didSchema,\n    role: z.string().refine(maxGraphemes(100)).max(1000).optional(),\n    displayName: z.string().refine(maxGraphemes(100)).max(1000).optional(),\n  })\n  .passthrough();\n\n/** site.standard.document */\nexport const StandardSiteDocumentRecordSchema = z\n  .object({\n    site: z.string().min(1),\n    title: z.string().min(1).refine(maxGraphemes(500)).max(5000),\n    path: z.string().optional(),\n    publishedAt: datetimeSchema,\n    updatedAt: datetimeSchema.optional(),\n    description: z.string().refine(maxGraphemes(3000)).max(30000).optional(),\n    textContent: z.string().optional(),\n    tags: z.array(z.string().refine(maxGraphemes(128)).max(1280)).optional(),\n    coverImage: blobRefSchema.optional(),\n    contributors: z.array(contributorSchema).optional(),\n    bskyPostRef: strongRefSchema.optional(),\n    labels: selfLabelsSchema.optional(),\n  })\n  .passthrough();\n\nexport type StandardSiteDocumentRecord = z.infer<typeof StandardSiteDocumentRecordSchema>;\n\n/**\n * site.standard.graph.subscription\n *\n * Authored by a viewer to declare a subscription to a publication. Used\n * by Phase 4 inline-subscribe path. Record key is a TID; the AT-URI\n * shape is `at://<viewer-did>/site.standard.graph.subscription/<rkey>`.\n */\nexport const StandardSiteSubscriptionRecordSchema = z.object({\n  publication: atUriSchema,\n  createdAt: datetimeSchema.optional(),\n});\n\nexport type StandardSiteSubscriptionRecord = z.infer<typeof StandardSiteSubscriptionRecordSchema>;\n\n/**\n * site.standard.graph.recommend\n *\n * Document-level \"like\" record. Same scope as subscription via the\n * site.standard.authSocial OAuth permission-set, so Phase 4 unlocks\n * inline likes alongside inline subscribes.\n */\nexport const StandardSiteRecommendRecordSchema = z.object({\n  document: atUriSchema,\n  createdAt: datetimeSchema,\n});\n\nexport type StandardSiteRecommendRecord = z.infer<typeof StandardSiteRecommendRecordSchema>;\n","/**\n * Publisher allowlist for the Standard.site rich embed.\n *\n * Mirrors `bluesky-social/social-app`\n * `src/components/Post/Embed/StandardSiteEmbed/publishers.ts`. The only\n * gate this provides is which publishers get the highlighted\n * \"Subscribe on {Publisher}\" CTA with a publisher icon vs the plain\n * \"View publication\" fallback — any Standard.site embed renders\n * regardless of allowlist membership.\n *\n * Sync policy: review additions against the upstream bsky list weekly;\n * Singi Labs reviews before merge.\n */\n\nexport interface Publisher {\n  /** Lowercase host. Subdomains are matched via `hostMatches`. */\n  host: string;\n  /** Human-facing publisher name shown in CTA copy. */\n  name: string;\n  /**\n   * Stable identifier used by clients to look up brand icons. The SDK\n   * does not ship icon assets — sifa-web maintains them keyed by this\n   * id so React Native vs web rendering can diverge.\n   */\n  iconKey: 'leaflet' | 'pckt' | 'offprint';\n}\n\nexport const STANDARD_SITE_PUBLISHERS: readonly Publisher[] = Object.freeze([\n  { host: 'leaflet.pub', name: 'Leaflet', iconKey: 'leaflet' },\n  { host: 'pckt.blog', name: 'pckt', iconKey: 'pckt' },\n  { host: 'offprint.app', name: 'Offprint', iconKey: 'offprint' },\n]);\n\n/**\n * Returns true when `host` exactly matches `target` or is a subdomain of\n * it. Hosts are expected to be lowercase already.\n */\nexport function hostMatches(host: string, target: string): boolean {\n  return host === target || host.endsWith('.' + target);\n}\n\nfunction hostFromUri(uri: string | undefined | null): string | null {\n  if (!uri) return null;\n  try {\n    return new URL(uri).host.toLowerCase();\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Match a publisher by host. Returns the publisher when `host` is on the\n * allowlist (exact or subdomain match), null otherwise. Host should be\n * lowercase.\n */\nexport function matchPublisherByHost(host: string | null | undefined): Publisher | null {\n  if (!host) return null;\n  const lower = host.toLowerCase();\n  return STANDARD_SITE_PUBLISHERS.find((p) => hostMatches(lower, p.host)) ?? null;\n}\n\n/**\n * Match a publisher by URI. Convenience wrapper around\n * `matchPublisherByHost` for callers that have a publication URL handy.\n */\nexport function matchPublisherByUri(uri: string | undefined | null): Publisher | null {\n  return matchPublisherByHost(hostFromUri(uri));\n}\n","import type { BasicTheme } from './schemas.js';\n\n/**\n * Publication metadata embedded in the augmented activity view by\n * sifa-api when an external link card matches an indexed publication.\n *\n * `uri` is the publication's AT-URI (e.g.\n * `at://did:plc:abc/site.standard.publication/xyz`). `theme` carries\n * the publication's own colors when supplied — clients should apply a\n * WCAG min-contrast fallback before honoring them.\n *\n * `icon` is left as `unknown` here because its representation depends\n * on the surface: blob ref on the wire, CDN URL after resolution.\n */\nexport interface PublicationSource {\n  uri: string;\n  title: string;\n  icon?: unknown;\n  theme?: BasicTheme;\n}\n\n/**\n * Shape attached to activity items whose external link card URL matches\n * a Standard.site record. Mirrors the relevant fields of bsky's\n * `StandardSiteEmbed` view so a sifa-web renderer can be near-1:1.\n *\n * `associatedRefs` carries AT-URIs the client may use in Phase 4 to\n * query subscription state for the viewer.\n */\nexport interface StandardSiteEmbedView {\n  uri: string;\n  source: PublicationSource;\n  associatedRefs: { uri: string }[];\n  createdAt?: string;\n  readingTime?: number;\n}\n\nexport const STANDARD_SITE_PUBLICATION_NSID = 'site.standard.publication' as const;\nexport const STANDARD_SITE_DOCUMENT_NSID = 'site.standard.document' as const;\nexport const STANDARD_SITE_SUBSCRIPTION_NSID = 'site.standard.graph.subscription' as const;\nexport const STANDARD_SITE_RECOMMEND_NSID = 'site.standard.graph.recommend' as const;\n\n/**\n * Pre-defined OAuth permission-set the consumer apps request to write\n * subscription + recommend records on behalf of the viewer. The actual\n * permission-set is published under\n * `at://did:plc:re3ebnp5v7ffagz6rb6xfei4/com.atproto.lexicon.schema/site.standard.authSocial`.\n */\nexport const STANDARD_SITE_AUTH_SOCIAL_NSID = 'site.standard.authSocial' as const;\n\nconst COLLECTION_SET = new Set<string>([\n  STANDARD_SITE_PUBLICATION_NSID,\n  STANDARD_SITE_DOCUMENT_NSID,\n  STANDARD_SITE_SUBSCRIPTION_NSID,\n  STANDARD_SITE_RECOMMEND_NSID,\n]);\n\n/**\n * True when the AT-URI's collection segment is a Standard.site\n * collection. Useful for detecting Standard.site embed augmentation on\n * arbitrary activity items.\n */\nexport function isStandardSiteAtUri(uri: string): boolean {\n  if (!uri.startsWith('at://')) return false;\n  const segments = uri.slice('at://'.length).split('/');\n  const collection = segments[1];\n  return collection !== undefined && COLLECTION_SET.has(collection);\n}\n\n/**\n * True when any `associatedRefs[].uri` is a Standard.site collection\n * AT-URI. The bsky client uses the same check to gate the\n * `StandardSiteEmbed` renderer.\n */\nexport function hasStandardSiteAssociatedRef(refs: { uri: string }[] | undefined): boolean {\n  if (!refs) return false;\n  return refs.some((r) => isStandardSiteAtUri(r.uri));\n}\n"]}

package/dist/query/index.d.cts

@@ -37,7 +37,7 @@ declare function useSifaConfig(): SifaApiConfig;
  * Pass `{ enabled: false }` (or an empty `handleOrDid`) to defer the
  * fetch.
  */
-declare function useProfile(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<Profile | null, Error, Profile | null, ReturnType<typeof sifaQueryKeys.profile.byHandle>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<Profile | null, Error>;
+declare function useProfile(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<Profile | null, Error, Profile | null, ReturnType<typeof sifaQueryKeys.profile.byHandle>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<Profile | null>, Error>;
 /**
  * React hook for a profile's AT Fund link. Returns `null` data on error
  * or when the profile has no link configured.
@@ -162,7 +162,7 @@ declare function useUpdateProfileLocation(ownerHandleOrDid: string, options?: Om
 declare function useDeleteProfileLocation(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;
 
 /** React hook for reading the external-accounts list. Returns `[]` data on error. */
-declare function useExternalAccounts(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<ExternalAccount[], Error, ExternalAccount[], ReturnType<typeof sifaQueryKeys.profile.externalAccounts>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<ExternalAccount[], Error>;
+declare function useExternalAccounts(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<ExternalAccount[], Error, ExternalAccount[], ReturnType<typeof sifaQueryKeys.profile.externalAccounts>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<ExternalAccount[]>, Error>;
 /** React hook for creating an external account. */
 declare function useCreateExternalAccount(ownerHandleOrDid: string, options?: Omit<UseMutationOptions<CreateExternalAccountResult, Error, ExternalAccountInput>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<CreateExternalAccountResult, Error, ExternalAccountInput, unknown>;
 /** Variables for {@link useUpdateExternalAccount}. */
@@ -230,43 +230,43 @@ declare const useBulkUnhideProfileItems: (ownerHandleOrDid: string, options?: Om
 /**
  * React hook for the public homepage stats. Returns `null` data on error.
  */
-declare function useStats(options?: Omit<UseQueryOptions<StatsResponse | null, Error, StatsResponse | null, ReturnType<typeof sifaQueryKeys.stats.homepage>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<StatsResponse | null, Error>;
+declare function useStats(options?: Omit<UseQueryOptions<StatsResponse | null, Error, StatsResponse | null, ReturnType<typeof sifaQueryKeys.stats.homepage>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<StatsResponse | null>, Error>;
 
 /** React hook for the public app registry. */
-declare function useAppsRegistry(options?: Omit<UseQueryOptions<AppRegistryEntry[], Error, AppRegistryEntry[], ReturnType<typeof sifaQueryKeys.apps.registry>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<AppRegistryEntry[], Error>;
+declare function useAppsRegistry(options?: Omit<UseQueryOptions<AppRegistryEntry[], Error, AppRegistryEntry[], ReturnType<typeof sifaQueryKeys.apps.registry>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<AppRegistryEntry[]>, Error>;
 /**
  * React hook for the authenticated user's hidden-apps list. Requires a
  * client-side session (relies on `credentials: 'include'`).
  */
-declare function useHiddenApps(options?: Omit<UseQueryOptions<HiddenApp[], Error, HiddenApp[], ReturnType<typeof sifaQueryKeys.apps.hidden>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<HiddenApp[], Error>;
+declare function useHiddenApps(options?: Omit<UseQueryOptions<HiddenApp[], Error, HiddenApp[], ReturnType<typeof sifaQueryKeys.apps.hidden>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<HiddenApp[]>, Error>;
 
-declare function useSearchProfiles(filters: SearchFilters, options?: Omit<UseQueryOptions<SearchResponse, Error, SearchResponse, ReturnType<typeof sifaQueryKeys.search.profiles>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SearchResponse, Error>;
-declare function useSkillSuggestions(query: string, options?: Omit<UseQueryOptions<SkillSearchResult[], Error, SkillSearchResult[], ReturnType<typeof sifaQueryKeys.search.skills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SkillSearchResult[], Error>;
+declare function useSearchProfiles(filters: SearchFilters, options?: Omit<UseQueryOptions<SearchResponse, Error, SearchResponse, ReturnType<typeof sifaQueryKeys.search.profiles>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SearchResponse>, Error>;
+declare function useSkillSuggestions(query: string, options?: Omit<UseQueryOptions<SkillSearchResult[], Error, SkillSearchResult[], ReturnType<typeof sifaQueryKeys.search.skills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SkillSearchResult[]>, Error>;
 /**
  * Canonical-skill search hook. Hits `/api/skills/search` (the
  * canonical-skills DB lookup, distinct from {@link useSkillSuggestions}'s
  * `/api/search/skills` profile-skill typeahead). Skips the network call
  * when the query is empty.
  */
-declare function useCanonicalSkillSearch(query: string, limit?: number, options?: Omit<UseQueryOptions<SkillSuggestion[], Error, SkillSuggestion[], ReturnType<typeof sifaQueryKeys.search.canonicalSkills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SkillSuggestion[], Error>;
-declare function useSearchFilters(options?: Omit<UseQueryOptions<FilterOptions, Error, FilterOptions, ReturnType<typeof sifaQueryKeys.search.filters>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FilterOptions, Error>;
+declare function useCanonicalSkillSearch(query: string, limit?: number, options?: Omit<UseQueryOptions<SkillSuggestion[], Error, SkillSuggestion[], ReturnType<typeof sifaQueryKeys.search.canonicalSkills>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SkillSuggestion[]>, Error>;
+declare function useSearchFilters(options?: Omit<UseQueryOptions<FilterOptions, Error, FilterOptions, ReturnType<typeof sifaQueryKeys.search.filters>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<FilterOptions>, Error>;
 
 declare function useSimilarProfiles(did: string | undefined | null, opts?: {
     limit?: number;
-}, options?: Omit<UseQueryOptions<SimilarProfile[], Error, SimilarProfile[], ReturnType<typeof sifaQueryKeys.discovery.similar>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SimilarProfile[], Error>;
-declare function useSuggestions(opts?: Omit<FetchSuggestionsOptions, keyof Omit<FetchSuggestionsOptions, 'source' | 'includeDismissed' | 'cursor' | 'limit'>>, options?: Omit<UseQueryOptions<SuggestionsResponse, Error, SuggestionsResponse, ReturnType<typeof sifaQueryKeys.discovery.suggestions>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<SuggestionsResponse, Error>;
+}, options?: Omit<UseQueryOptions<SimilarProfile[], Error, SimilarProfile[], ReturnType<typeof sifaQueryKeys.discovery.similar>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SimilarProfile[]>, Error>;
+declare function useSuggestions(opts?: Omit<FetchSuggestionsOptions, keyof Omit<FetchSuggestionsOptions, 'source' | 'includeDismissed' | 'cursor' | 'limit'>>, options?: Omit<UseQueryOptions<SuggestionsResponse, Error, SuggestionsResponse, ReturnType<typeof sifaQueryKeys.discovery.suggestions>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<SuggestionsResponse>, Error>;
 declare function useSuggestionCount(since?: string, options?: Omit<UseQueryOptions<number, Error, number, ReturnType<typeof sifaQueryKeys.discovery.suggestionCount>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<number, Error>;
-declare function useFeaturedProfile(options?: Omit<UseQueryOptions<FeaturedProfile | null, Error, FeaturedProfile | null, ReturnType<typeof sifaQueryKeys.discovery.featured>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FeaturedProfile | null, Error>;
+declare function useFeaturedProfile(options?: Omit<UseQueryOptions<FeaturedProfile | null, Error, FeaturedProfile | null, ReturnType<typeof sifaQueryKeys.discovery.featured>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<FeaturedProfile | null>, Error>;
 
 declare function useFollowing(opts?: {
     source?: string;
     cursor?: string;
     limit?: number;
-}, options?: Omit<UseQueryOptions<FollowingResponse, Error, FollowingResponse, ReturnType<typeof sifaQueryKeys.follow.following>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<FollowingResponse, Error>;
+}, options?: Omit<UseQueryOptions<FollowingResponse, Error, FollowingResponse, ReturnType<typeof sifaQueryKeys.follow.following>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<FollowingResponse>, Error>;
 
-declare function useHeatmapData(handleOrDid: string | undefined | null, days: number, options?: Omit<UseQueryOptions<HeatmapResponse | null, Error, HeatmapResponse | null, ReturnType<typeof sifaQueryKeys.activity.heatmap>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<HeatmapResponse | null, Error>;
-declare function useActivityTeaser(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<ActivityTeaserResponse | null, Error, ActivityTeaserResponse | null, ReturnType<typeof sifaQueryKeys.activity.teaser>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<ActivityTeaserResponse | null, Error>;
-declare function useActivityFeed(handleOrDid: string | undefined | null, opts?: Pick<FetchActivityFeedOptions, 'category' | 'limit' | 'cursor'>, options?: Omit<UseQueryOptions<ActivityFeedResponse | null, Error, ActivityFeedResponse | null, ReturnType<typeof sifaQueryKeys.activity.feed>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<ActivityFeedResponse | null, Error>;
+declare function useHeatmapData(handleOrDid: string | undefined | null, days: number, options?: Omit<UseQueryOptions<HeatmapResponse | null, Error, HeatmapResponse | null, ReturnType<typeof sifaQueryKeys.activity.heatmap>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<HeatmapResponse | null>, Error>;
+declare function useActivityTeaser(handleOrDid: string | undefined | null, options?: Omit<UseQueryOptions<ActivityTeaserResponse | null, Error, ActivityTeaserResponse | null, ReturnType<typeof sifaQueryKeys.activity.teaser>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<ActivityTeaserResponse | null>, Error>;
+declare function useActivityFeed(handleOrDid: string | undefined | null, opts?: Pick<FetchActivityFeedOptions, 'category' | 'limit' | 'cursor'>, options?: Omit<UseQueryOptions<ActivityFeedResponse | null, Error, ActivityFeedResponse | null, ReturnType<typeof sifaQueryKeys.activity.feed>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<ActivityFeedResponse | null>, Error>;
 
 /** Count of confirmed endorsements for a DID. Returns 0 on error. */
 declare function useEndorsementCount(did: string | undefined | null, options?: Omit<UseQueryOptions<number, Error, number, ReturnType<typeof sifaQueryKeys.endorsement.count>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<number, Error>;
@@ -281,9 +281,9 @@ declare function useNetworkStreamCount(did: string | undefined | null, options?:
  * Batch-look up reaction status for multiple URIs. Skips the network call
  * when `uris` is empty.
  */
-declare function useReactionStatus(uris: string[], options?: Omit<UseQueryOptions<Record<string, ReactionStatus> | null, Error, Record<string, ReactionStatus> | null, ReturnType<typeof sifaQueryKeys.reactions.status>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<Record<string, ReactionStatus> | null, Error>;
+declare function useReactionStatus(uris: string[], options?: Omit<UseQueryOptions<Record<string, ReactionStatus> | null, Error, Record<string, ReactionStatus> | null, ReturnType<typeof sifaQueryKeys.reactions.status>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<Record<string, ReactionStatus> | null>, Error>;
 /** Check whether the authenticated viewer has an account on the given app. */
-declare function useAppAccountCheck(appId: string | undefined | null, options?: Omit<UseQueryOptions<AccountCheckResult | null, Error, AccountCheckResult | null, ReturnType<typeof sifaQueryKeys.reactions.accountCheck>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<AccountCheckResult | null, Error>;
+declare function useAppAccountCheck(appId: string | undefined | null, options?: Omit<UseQueryOptions<AccountCheckResult | null, Error, AccountCheckResult | null, ReturnType<typeof sifaQueryKeys.reactions.accountCheck>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<AccountCheckResult | null>, Error>;
 
 /** Variables for {@link useCreateReaction}. */
 interface CreateReactionVariables {
@@ -323,9 +323,9 @@ interface DeleteReactionVariables {
 declare function useDeleteReaction(options?: Omit<UseMutationOptions<WriteResult, Error, DeleteReactionVariables>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, DeleteReactionVariables, unknown>;
 
 /** Public roadmap vote tallies. Returns `{}` data on error. */
-declare function useRoadmapVotes(options?: Omit<UseQueryOptions<RoadmapVotesResponse, Error, RoadmapVotesResponse, ReturnType<typeof sifaQueryKeys.roadmap.votes>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<RoadmapVotesResponse, Error>;
+declare function useRoadmapVotes(options?: Omit<UseQueryOptions<RoadmapVotesResponse, Error, RoadmapVotesResponse, ReturnType<typeof sifaQueryKeys.roadmap.votes>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<RoadmapVotesResponse>, Error>;
 /** Roadmap items the authenticated viewer has voted on. Returns `[]` data on error. */
-declare function useMyRoadmapVotes(options?: Omit<UseQueryOptions<string[], Error, string[], ReturnType<typeof sifaQueryKeys.roadmap.myVotes>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<string[], Error>;
+declare function useMyRoadmapVotes(options?: Omit<UseQueryOptions<string[], Error, string[], ReturnType<typeof sifaQueryKeys.roadmap.myVotes>>, 'queryKey' | 'queryFn'>): _tanstack_react_query.UseQueryResult<NoInfer<string[]>, Error>;
 
 /** React hook for casting a roadmap vote. Variable: the item key. */
 declare function useCastRoadmapVote(options?: Omit<UseMutationOptions<WriteResult, Error, string>, 'mutationFn'>): _tanstack_react_query.UseMutationResult<WriteResult, Error, string, unknown>;