@singi-labs/sifa-sdk 0.9.12 → 0.9.14

package/dist/publishing/index.cjs

@@ -0,0 +1,155 @@
+'use strict';
+
+var zod = require('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 = zod.z.string().regex(/^did:[a-z]+:[a-zA-Z0-9._:%-]+$/, "Invalid DID");
+var datetimeSchema = zod.z.string().datetime({ offset: true });
+var atUriSchema = zod.z.string().regex(/^at:\/\/[^\s]+$/, "Invalid AT-URI");
+var cidSchema = zod.z.string().regex(/^(Qm[1-9A-HJ-NP-Za-km-z]{44}|b[A-Za-z0-9+/=]+)$/, "Invalid CID");
+zod.z.string().regex(/^[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*$/, "Invalid BCP 47 language tag");
+var uriSchema = zod.z.string().url();
+var strongRefSchema = zod.z.object({
+  uri: atUriSchema,
+  cid: cidSchema
+});
+var selfLabelsSchema = zod.z.object({
+  $type: zod.z.literal("com.atproto.label.defs#selfLabels").optional(),
+  values: zod.z.array(zod.z.object({ val: zod.z.string() }))
+});
+
+// src/publishing/schemas.ts
+var rgbColorSchema = zod.z.object({
+  r: zod.z.number().int().min(0).max(255),
+  g: zod.z.number().int().min(0).max(255),
+  b: zod.z.number().int().min(0).max(255)
+});
+var BasicThemeSchema = zod.z.object({
+  background: rgbColorSchema,
+  foreground: rgbColorSchema,
+  accent: rgbColorSchema,
+  accentForeground: rgbColorSchema
+});
+var blobRefSchema = zod.z.object({
+  $type: zod.z.string().optional(),
+  ref: zod.z.unknown(),
+  mimeType: zod.z.string().optional(),
+  size: zod.z.number().optional()
+}).passthrough();
+var StandardSitePublicationRecordSchema = zod.z.object({
+  url: uriSchema,
+  name: zod.z.string().min(1).refine(maxGraphemes(500)).max(5e3),
+  description: zod.z.string().refine(maxGraphemes(3e3)).max(3e4).optional(),
+  icon: blobRefSchema.optional(),
+  basicTheme: BasicThemeSchema.optional(),
+  labels: selfLabelsSchema.optional(),
+  preferences: zod.z.object({
+    showInDiscover: zod.z.boolean().optional()
+  }).partial().optional()
+}).passthrough();
+var contributorSchema = zod.z.object({
+  did: didSchema,
+  role: zod.z.string().refine(maxGraphemes(100)).max(1e3).optional(),
+  displayName: zod.z.string().refine(maxGraphemes(100)).max(1e3).optional()
+}).passthrough();
+var StandardSiteDocumentRecordSchema = zod.z.object({
+  site: zod.z.string().min(1),
+  title: zod.z.string().min(1).refine(maxGraphemes(500)).max(5e3),
+  path: zod.z.string().optional(),
+  publishedAt: datetimeSchema,
+  updatedAt: datetimeSchema.optional(),
+  description: zod.z.string().refine(maxGraphemes(3e3)).max(3e4).optional(),
+  textContent: zod.z.string().optional(),
+  tags: zod.z.array(zod.z.string().refine(maxGraphemes(128)).max(1280)).optional(),
+  coverImage: blobRefSchema.optional(),
+  contributors: zod.z.array(contributorSchema).optional(),
+  bskyPostRef: strongRefSchema.optional(),
+  labels: selfLabelsSchema.optional()
+}).passthrough();
+var StandardSiteSubscriptionRecordSchema = zod.z.object({
+  publication: atUriSchema,
+  createdAt: datetimeSchema.optional()
+});
+var StandardSiteRecommendRecordSchema = zod.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));
+}
+
+exports.BasicThemeSchema = BasicThemeSchema;
+exports.STANDARD_SITE_AUTH_SOCIAL_NSID = STANDARD_SITE_AUTH_SOCIAL_NSID;
+exports.STANDARD_SITE_DOCUMENT_NSID = STANDARD_SITE_DOCUMENT_NSID;
+exports.STANDARD_SITE_PUBLICATION_NSID = STANDARD_SITE_PUBLICATION_NSID;
+exports.STANDARD_SITE_PUBLISHERS = STANDARD_SITE_PUBLISHERS;
+exports.STANDARD_SITE_RECOMMEND_NSID = STANDARD_SITE_RECOMMEND_NSID;
+exports.STANDARD_SITE_SUBSCRIPTION_NSID = STANDARD_SITE_SUBSCRIPTION_NSID;
+exports.StandardSiteDocumentRecordSchema = StandardSiteDocumentRecordSchema;
+exports.StandardSitePublicationRecordSchema = StandardSitePublicationRecordSchema;
+exports.StandardSiteRecommendRecordSchema = StandardSiteRecommendRecordSchema;
+exports.StandardSiteSubscriptionRecordSchema = StandardSiteSubscriptionRecordSchema;
+exports.hasStandardSiteAssociatedRef = hasStandardSiteAssociatedRef;
+exports.hostMatches = hostMatches;
+exports.isStandardSiteAtUri = isStandardSiteAtUri;
+exports.matchPublisherByHost = matchPublisherByHost;
+exports.matchPublisherByUri = matchPublisherByUri;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/publishing/index.cjs.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.cjs","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/publishing/index.d.cts

@@ -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 };