@singi-labs/sifa-sdk 0.19.37 → 0.19.38

package/dist/rpg/index.cjs

@@ -0,0 +1,122 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/rpg/catalog.ts
+var RpgUnlockSchema = zod.z.discriminatedUnion("kind", [
+  zod.z.object({
+    kind: zod.z.literal("hasRecord"),
+    collection: zod.z.enum([
+      "id.sifa.profile.position",
+      "id.sifa.profile.volunteering",
+      "id.sifa.profile.presentation",
+      "id.sifa.profile.education"
+    ])
+  }),
+  zod.z.object({ kind: zod.z.literal("hasExternalAccount"), platforms: zod.z.array(zod.z.string()).min(1) }),
+  zod.z.object({ kind: zod.z.literal("usesApp"), appId: zod.z.string().min(1) }),
+  zod.z.object({ kind: zod.z.literal("hasDoctorate") })
+]);
+var RpgItemSchema = zod.z.object({
+  /** Lowercase `[a-z0-9_]` only: the id is embedded in an AT Protocol record key. */
+  id: zod.z.string().min(1).max(50).regex(/^[a-z0-9_]+$/),
+  title: zod.z.string().max(100),
+  description: zod.z.string().max(500),
+  kind: zod.z.enum(["layer", "held"]),
+  category: zod.z.string().max(30),
+  unlock: zod.z.array(RpgUnlockSchema).min(1),
+  // ANY of these unlocks the item
+  enabled: zod.z.boolean()
+});
+var RPG_ITEMS = [
+  {
+    id: "sifa_power_suit",
+    title: "Power Suit",
+    description: "",
+    kind: "layer",
+    category: "tops",
+    enabled: true,
+    unlock: [{ kind: "hasRecord", collection: "id.sifa.profile.position" }]
+  },
+  {
+    id: "sifa_weekend_shirt",
+    title: "Weekend Shirt",
+    description: "",
+    kind: "layer",
+    category: "tops",
+    enabled: true,
+    unlock: [{ kind: "hasRecord", collection: "id.sifa.profile.volunteering" }]
+  },
+  {
+    id: "sifa_speaker_mic",
+    title: "Speaker Mic",
+    description: "",
+    kind: "held",
+    category: "righthand",
+    enabled: true,
+    unlock: [{ kind: "hasRecord", collection: "id.sifa.profile.presentation" }]
+  },
+  {
+    id: "sifa_school_books",
+    title: "School Books",
+    description: "",
+    kind: "held",
+    category: "lefthand",
+    enabled: true,
+    unlock: [{ kind: "hasRecord", collection: "id.sifa.profile.education" }]
+  },
+  {
+    id: "sifa_doctoral_cap",
+    title: "Doctoral Cap",
+    description: "",
+    kind: "layer",
+    category: "headwear",
+    enabled: false,
+    unlock: [{ kind: "hasDoctorate" }]
+  },
+  {
+    id: "sifa_lab_coat",
+    title: "Lab Coat",
+    description: "",
+    kind: "layer",
+    category: "tops",
+    enabled: true,
+    unlock: [{ kind: "hasExternalAccount", platforms: ["orcid"] }]
+  },
+  {
+    id: "sifa_dev_hoodie",
+    title: "Dev Hoodie",
+    description: "",
+    kind: "layer",
+    category: "tops",
+    enabled: true,
+    unlock: [
+      { kind: "hasExternalAccount", platforms: ["github"] },
+      { kind: "usesApp", appId: "tangled" }
+    ]
+  }
+];
+
+// src/rpg/unlocks.ts
+function matches(u, s) {
+  switch (u.kind) {
+    case "hasRecord":
+      return s.collections.includes(u.collection);
+    case "hasExternalAccount":
+      return u.platforms.some((p) => s.externalPlatforms.includes(p));
+    case "usesApp":
+      return s.activeAppIds.includes(u.appId);
+    case "hasDoctorate":
+      return s.hasDoctorate;
+  }
+}
+function evaluateRpgUnlocks(signals, items = RPG_ITEMS) {
+  return items.filter((item) => item.enabled).map((item) => ({ item, earned: item.unlock.some((u) => matches(u, signals)) }));
+}
+
+exports.RPG_ITEMS = RPG_ITEMS;
+exports.RpgItemSchema = RpgItemSchema;
+exports.RpgUnlockSchema = RpgUnlockSchema;
+exports.evaluateRpgUnlocks = evaluateRpgUnlocks;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/rpg/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/rpg/catalog.ts","../../src/rpg/unlocks.ts"],"names":["z"],"mappings":"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","file":"index.cjs","sourcesContent":["import { z } from 'zod';\n\nexport const RpgUnlockSchema = z.discriminatedUnion('kind', [\n  z.object({\n    kind: z.literal('hasRecord'),\n    collection: z.enum([\n      'id.sifa.profile.position',\n      'id.sifa.profile.volunteering',\n      'id.sifa.profile.presentation',\n      'id.sifa.profile.education',\n    ]),\n  }),\n  z.object({ kind: z.literal('hasExternalAccount'), platforms: z.array(z.string()).min(1) }),\n  z.object({ kind: z.literal('usesApp'), appId: z.string().min(1) }),\n  z.object({ kind: z.literal('hasDoctorate') }),\n]);\n\nexport const RpgItemSchema = z.object({\n  /** Lowercase `[a-z0-9_]` only: the id is embedded in an AT Protocol record key. */\n  id: z\n    .string()\n    .min(1)\n    .max(50)\n    .regex(/^[a-z0-9_]+$/),\n  title: z.string().max(100),\n  description: z.string().max(500),\n  kind: z.enum(['layer', 'held']),\n  category: z.string().max(30),\n  unlock: z.array(RpgUnlockSchema).min(1), // ANY of these unlocks the item\n  enabled: z.boolean(),\n});\nexport type RpgItem = z.infer<typeof RpgItemSchema>;\nexport type RpgUnlock = z.infer<typeof RpgUnlockSchema>;\n\n/**\n * The Sifa item catalog for rpg.actor. PLACEHOLDER titles/categories until\n * rpg.actor transfers the real item cores.\n */\nexport const RPG_ITEMS: readonly RpgItem[] = [\n  {\n    id: 'sifa_power_suit',\n    title: 'Power Suit',\n    description: '',\n    kind: 'layer',\n    category: 'tops',\n    enabled: true,\n    unlock: [{ kind: 'hasRecord', collection: 'id.sifa.profile.position' }],\n  },\n  {\n    id: 'sifa_weekend_shirt',\n    title: 'Weekend Shirt',\n    description: '',\n    kind: 'layer',\n    category: 'tops',\n    enabled: true,\n    unlock: [{ kind: 'hasRecord', collection: 'id.sifa.profile.volunteering' }],\n  },\n  {\n    id: 'sifa_speaker_mic',\n    title: 'Speaker Mic',\n    description: '',\n    kind: 'held',\n    category: 'righthand',\n    enabled: true,\n    unlock: [{ kind: 'hasRecord', collection: 'id.sifa.profile.presentation' }],\n  },\n  {\n    id: 'sifa_school_books',\n    title: 'School Books',\n    description: '',\n    kind: 'held',\n    category: 'lefthand',\n    enabled: true,\n    unlock: [{ kind: 'hasRecord', collection: 'id.sifa.profile.education' }],\n  },\n  {\n    id: 'sifa_doctoral_cap',\n    title: 'Doctoral Cap',\n    description: '',\n    kind: 'layer',\n    category: 'headwear',\n    enabled: false,\n    unlock: [{ kind: 'hasDoctorate' }],\n  },\n  {\n    id: 'sifa_lab_coat',\n    title: 'Lab Coat',\n    description: '',\n    kind: 'layer',\n    category: 'tops',\n    enabled: true,\n    unlock: [{ kind: 'hasExternalAccount', platforms: ['orcid'] }],\n  },\n  {\n    id: 'sifa_dev_hoodie',\n    title: 'Dev Hoodie',\n    description: '',\n    kind: 'layer',\n    category: 'tops',\n    enabled: true,\n    unlock: [\n      { kind: 'hasExternalAccount', platforms: ['github'] },\n      { kind: 'usesApp', appId: 'tangled' },\n    ],\n  },\n];\n","import { RPG_ITEMS, type RpgItem, type RpgUnlock } from './catalog.js';\n\n/**\n * Profile signals the unlock rules are checked against. Callers must pass\n * lowercase platform codes (e.g. 'github', 'orcid') and registry app ids (e.g. 'tangled').\n */\nexport interface RpgUnlockSignals {\n  collections: readonly string[];\n  externalPlatforms: readonly string[];\n  activeAppIds: readonly string[];\n  hasDoctorate: boolean;\n}\n\n/** One enabled catalog item and whether the signals earn it. */\nexport interface RpgUnlockResult {\n  item: RpgItem;\n  earned: boolean;\n}\n\nfunction matches(u: RpgUnlock, s: RpgUnlockSignals): boolean {\n  switch (u.kind) {\n    case 'hasRecord':\n      return s.collections.includes(u.collection);\n    case 'hasExternalAccount':\n      return u.platforms.some((p) => s.externalPlatforms.includes(p));\n    case 'usesApp':\n      return s.activeAppIds.includes(u.appId);\n    case 'hasDoctorate':\n      return s.hasDoctorate;\n  }\n}\n\n/** Evaluate every enabled item (ANY matching unlock earns it); disabled items are omitted. */\nexport function evaluateRpgUnlocks(\n  signals: RpgUnlockSignals,\n  items: readonly RpgItem[] = RPG_ITEMS,\n): RpgUnlockResult[] {\n  return items\n    .filter((item) => item.enabled)\n    .map((item) => ({ item, earned: item.unlock.some((u) => matches(u, signals)) }));\n}\n"]}

package/dist/rpg/index.d.cts

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+
+declare const RpgUnlockSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"hasRecord">;
+    collection: z.ZodEnum<{
+        "id.sifa.profile.position": "id.sifa.profile.position";
+        "id.sifa.profile.volunteering": "id.sifa.profile.volunteering";
+        "id.sifa.profile.presentation": "id.sifa.profile.presentation";
+        "id.sifa.profile.education": "id.sifa.profile.education";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"hasExternalAccount">;
+    platforms: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"usesApp">;
+    appId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"hasDoctorate">;
+}, z.core.$strip>], "kind">;
+declare const RpgItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    kind: z.ZodEnum<{
+        layer: "layer";
+        held: "held";
+    }>;
+    category: z.ZodString;
+    unlock: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"hasRecord">;
+        collection: z.ZodEnum<{
+            "id.sifa.profile.position": "id.sifa.profile.position";
+            "id.sifa.profile.volunteering": "id.sifa.profile.volunteering";
+            "id.sifa.profile.presentation": "id.sifa.profile.presentation";
+            "id.sifa.profile.education": "id.sifa.profile.education";
+        }>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"hasExternalAccount">;
+        platforms: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"usesApp">;
+        appId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"hasDoctorate">;
+    }, z.core.$strip>], "kind">>;
+    enabled: z.ZodBoolean;
+}, z.core.$strip>;
+type RpgItem = z.infer<typeof RpgItemSchema>;
+type RpgUnlock = z.infer<typeof RpgUnlockSchema>;
+/**
+ * The Sifa item catalog for rpg.actor. PLACEHOLDER titles/categories until
+ * rpg.actor transfers the real item cores.
+ */
+declare const RPG_ITEMS: readonly RpgItem[];
+
+/**
+ * Profile signals the unlock rules are checked against. Callers must pass
+ * lowercase platform codes (e.g. 'github', 'orcid') and registry app ids (e.g. 'tangled').
+ */
+interface RpgUnlockSignals {
+    collections: readonly string[];
+    externalPlatforms: readonly string[];
+    activeAppIds: readonly string[];
+    hasDoctorate: boolean;
+}
+/** One enabled catalog item and whether the signals earn it. */
+interface RpgUnlockResult {
+    item: RpgItem;
+    earned: boolean;
+}
+/** Evaluate every enabled item (ANY matching unlock earns it); disabled items are omitted. */
+declare function evaluateRpgUnlocks(signals: RpgUnlockSignals, items?: readonly RpgItem[]): RpgUnlockResult[];
+
+export { RPG_ITEMS, type RpgItem, RpgItemSchema, type RpgUnlock, type RpgUnlockResult, RpgUnlockSchema, type RpgUnlockSignals, evaluateRpgUnlocks };

package/dist/rpg/index.d.ts

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+
+declare const RpgUnlockSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"hasRecord">;
+    collection: z.ZodEnum<{
+        "id.sifa.profile.position": "id.sifa.profile.position";
+        "id.sifa.profile.volunteering": "id.sifa.profile.volunteering";
+        "id.sifa.profile.presentation": "id.sifa.profile.presentation";
+        "id.sifa.profile.education": "id.sifa.profile.education";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"hasExternalAccount">;
+    platforms: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"usesApp">;
+    appId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"hasDoctorate">;
+}, z.core.$strip>], "kind">;
+declare const RpgItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    kind: z.ZodEnum<{
+        layer: "layer";
+        held: "held";
+    }>;
+    category: z.ZodString;
+    unlock: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"hasRecord">;
+        collection: z.ZodEnum<{
+            "id.sifa.profile.position": "id.sifa.profile.position";
+            "id.sifa.profile.volunteering": "id.sifa.profile.volunteering";
+            "id.sifa.profile.presentation": "id.sifa.profile.presentation";
+            "id.sifa.profile.education": "id.sifa.profile.education";
+        }>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"hasExternalAccount">;
+        platforms: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"usesApp">;
+        appId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"hasDoctorate">;
+    }, z.core.$strip>], "kind">>;
+    enabled: z.ZodBoolean;
+}, z.core.$strip>;
+type RpgItem = z.infer<typeof RpgItemSchema>;
+type RpgUnlock = z.infer<typeof RpgUnlockSchema>;
+/**
+ * The Sifa item catalog for rpg.actor. PLACEHOLDER titles/categories until
+ * rpg.actor transfers the real item cores.
+ */
+declare const RPG_ITEMS: readonly RpgItem[];
+
+/**
+ * Profile signals the unlock rules are checked against. Callers must pass
+ * lowercase platform codes (e.g. 'github', 'orcid') and registry app ids (e.g. 'tangled').
+ */
+interface RpgUnlockSignals {
+    collections: readonly string[];
+    externalPlatforms: readonly string[];
+    activeAppIds: readonly string[];
+    hasDoctorate: boolean;
+}
+/** One enabled catalog item and whether the signals earn it. */
+interface RpgUnlockResult {
+    item: RpgItem;
+    earned: boolean;
+}
+/** Evaluate every enabled item (ANY matching unlock earns it); disabled items are omitted. */
+declare function evaluateRpgUnlocks(signals: RpgUnlockSignals, items?: readonly RpgItem[]): RpgUnlockResult[];
+
+export { RPG_ITEMS, type RpgItem, RpgItemSchema, type RpgUnlock, type RpgUnlockResult, RpgUnlockSchema, type RpgUnlockSignals, evaluateRpgUnlocks };

package/dist/rpg/index.js

@@ -0,0 +1,117 @@
+import { z } from 'zod';
+
+// src/rpg/catalog.ts
+var RpgUnlockSchema = z.discriminatedUnion("kind", [
+  z.object({
+    kind: z.literal("hasRecord"),
+    collection: z.enum([
+      "id.sifa.profile.position",
+      "id.sifa.profile.volunteering",
+      "id.sifa.profile.presentation",
+      "id.sifa.profile.education"
+    ])
+  }),
+  z.object({ kind: z.literal("hasExternalAccount"), platforms: z.array(z.string()).min(1) }),
+  z.object({ kind: z.literal("usesApp"), appId: z.string().min(1) }),
+  z.object({ kind: z.literal("hasDoctorate") })
+]);
+var RpgItemSchema = z.object({
+  /** Lowercase `[a-z0-9_]` only: the id is embedded in an AT Protocol record key. */
+  id: z.string().min(1).max(50).regex(/^[a-z0-9_]+$/),
+  title: z.string().max(100),
+  description: z.string().max(500),
+  kind: z.enum(["layer", "held"]),
+  category: z.string().max(30),
+  unlock: z.array(RpgUnlockSchema).min(1),
+  // ANY of these unlocks the item
+  enabled: z.boolean()
+});
+var RPG_ITEMS = [
+  {
+    id: "sifa_power_suit",
+    title: "Power Suit",
+    description: "",
+    kind: "layer",
+    category: "tops",
+    enabled: true,
+    unlock: [{ kind: "hasRecord", collection: "id.sifa.profile.position" }]
+  },
+  {
+    id: "sifa_weekend_shirt",
+    title: "Weekend Shirt",
+    description: "",
+    kind: "layer",
+    category: "tops",
+    enabled: true,
+    unlock: [{ kind: "hasRecord", collection: "id.sifa.profile.volunteering" }]
+  },
+  {
+    id: "sifa_speaker_mic",
+    title: "Speaker Mic",
+    description: "",
+    kind: "held",
+    category: "righthand",
+    enabled: true,
+    unlock: [{ kind: "hasRecord", collection: "id.sifa.profile.presentation" }]
+  },
+  {
+    id: "sifa_school_books",
+    title: "School Books",
+    description: "",
+    kind: "held",
+    category: "lefthand",
+    enabled: true,
+    unlock: [{ kind: "hasRecord", collection: "id.sifa.profile.education" }]
+  },
+  {
+    id: "sifa_doctoral_cap",
+    title: "Doctoral Cap",
+    description: "",
+    kind: "layer",
+    category: "headwear",
+    enabled: false,
+    unlock: [{ kind: "hasDoctorate" }]
+  },
+  {
+    id: "sifa_lab_coat",
+    title: "Lab Coat",
+    description: "",
+    kind: "layer",
+    category: "tops",
+    enabled: true,
+    unlock: [{ kind: "hasExternalAccount", platforms: ["orcid"] }]
+  },
+  {
+    id: "sifa_dev_hoodie",
+    title: "Dev Hoodie",
+    description: "",
+    kind: "layer",
+    category: "tops",
+    enabled: true,
+    unlock: [
+      { kind: "hasExternalAccount", platforms: ["github"] },
+      { kind: "usesApp", appId: "tangled" }
+    ]
+  }
+];
+
+// src/rpg/unlocks.ts
+function matches(u, s) {
+  switch (u.kind) {
+    case "hasRecord":
+      return s.collections.includes(u.collection);
+    case "hasExternalAccount":
+      return u.platforms.some((p) => s.externalPlatforms.includes(p));
+    case "usesApp":
+      return s.activeAppIds.includes(u.appId);
+    case "hasDoctorate":
+      return s.hasDoctorate;
+  }
+}
+function evaluateRpgUnlocks(signals, items = RPG_ITEMS) {
+  return items.filter((item) => item.enabled).map((item) => ({ item, earned: item.unlock.some((u) => matches(u, signals)) }));
+}
+
+export { RPG_ITEMS, RpgItemSchema, RpgUnlockSchema, evaluateRpgUnlocks };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/rpg/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/rpg/catalog.ts","../../src/rpg/unlocks.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { z } from 'zod';\n\nexport const RpgUnlockSchema = z.discriminatedUnion('kind', [\n  z.object({\n    kind: z.literal('hasRecord'),\n    collection: z.enum([\n      'id.sifa.profile.position',\n      'id.sifa.profile.volunteering',\n      'id.sifa.profile.presentation',\n      'id.sifa.profile.education',\n    ]),\n  }),\n  z.object({ kind: z.literal('hasExternalAccount'), platforms: z.array(z.string()).min(1) }),\n  z.object({ kind: z.literal('usesApp'), appId: z.string().min(1) }),\n  z.object({ kind: z.literal('hasDoctorate') }),\n]);\n\nexport const RpgItemSchema = z.object({\n  /** Lowercase `[a-z0-9_]` only: the id is embedded in an AT Protocol record key. */\n  id: z\n    .string()\n    .min(1)\n    .max(50)\n    .regex(/^[a-z0-9_]+$/),\n  title: z.string().max(100),\n  description: z.string().max(500),\n  kind: z.enum(['layer', 'held']),\n  category: z.string().max(30),\n  unlock: z.array(RpgUnlockSchema).min(1), // ANY of these unlocks the item\n  enabled: z.boolean(),\n});\nexport type RpgItem = z.infer<typeof RpgItemSchema>;\nexport type RpgUnlock = z.infer<typeof RpgUnlockSchema>;\n\n/**\n * The Sifa item catalog for rpg.actor. PLACEHOLDER titles/categories until\n * rpg.actor transfers the real item cores.\n */\nexport const RPG_ITEMS: readonly RpgItem[] = [\n  {\n    id: 'sifa_power_suit',\n    title: 'Power Suit',\n    description: '',\n    kind: 'layer',\n    category: 'tops',\n    enabled: true,\n    unlock: [{ kind: 'hasRecord', collection: 'id.sifa.profile.position' }],\n  },\n  {\n    id: 'sifa_weekend_shirt',\n    title: 'Weekend Shirt',\n    description: '',\n    kind: 'layer',\n    category: 'tops',\n    enabled: true,\n    unlock: [{ kind: 'hasRecord', collection: 'id.sifa.profile.volunteering' }],\n  },\n  {\n    id: 'sifa_speaker_mic',\n    title: 'Speaker Mic',\n    description: '',\n    kind: 'held',\n    category: 'righthand',\n    enabled: true,\n    unlock: [{ kind: 'hasRecord', collection: 'id.sifa.profile.presentation' }],\n  },\n  {\n    id: 'sifa_school_books',\n    title: 'School Books',\n    description: '',\n    kind: 'held',\n    category: 'lefthand',\n    enabled: true,\n    unlock: [{ kind: 'hasRecord', collection: 'id.sifa.profile.education' }],\n  },\n  {\n    id: 'sifa_doctoral_cap',\n    title: 'Doctoral Cap',\n    description: '',\n    kind: 'layer',\n    category: 'headwear',\n    enabled: false,\n    unlock: [{ kind: 'hasDoctorate' }],\n  },\n  {\n    id: 'sifa_lab_coat',\n    title: 'Lab Coat',\n    description: '',\n    kind: 'layer',\n    category: 'tops',\n    enabled: true,\n    unlock: [{ kind: 'hasExternalAccount', platforms: ['orcid'] }],\n  },\n  {\n    id: 'sifa_dev_hoodie',\n    title: 'Dev Hoodie',\n    description: '',\n    kind: 'layer',\n    category: 'tops',\n    enabled: true,\n    unlock: [\n      { kind: 'hasExternalAccount', platforms: ['github'] },\n      { kind: 'usesApp', appId: 'tangled' },\n    ],\n  },\n];\n","import { RPG_ITEMS, type RpgItem, type RpgUnlock } from './catalog.js';\n\n/**\n * Profile signals the unlock rules are checked against. Callers must pass\n * lowercase platform codes (e.g. 'github', 'orcid') and registry app ids (e.g. 'tangled').\n */\nexport interface RpgUnlockSignals {\n  collections: readonly string[];\n  externalPlatforms: readonly string[];\n  activeAppIds: readonly string[];\n  hasDoctorate: boolean;\n}\n\n/** One enabled catalog item and whether the signals earn it. */\nexport interface RpgUnlockResult {\n  item: RpgItem;\n  earned: boolean;\n}\n\nfunction matches(u: RpgUnlock, s: RpgUnlockSignals): boolean {\n  switch (u.kind) {\n    case 'hasRecord':\n      return s.collections.includes(u.collection);\n    case 'hasExternalAccount':\n      return u.platforms.some((p) => s.externalPlatforms.includes(p));\n    case 'usesApp':\n      return s.activeAppIds.includes(u.appId);\n    case 'hasDoctorate':\n      return s.hasDoctorate;\n  }\n}\n\n/** Evaluate every enabled item (ANY matching unlock earns it); disabled items are omitted. */\nexport function evaluateRpgUnlocks(\n  signals: RpgUnlockSignals,\n  items: readonly RpgItem[] = RPG_ITEMS,\n): RpgUnlockResult[] {\n  return items\n    .filter((item) => item.enabled)\n    .map((item) => ({ item, earned: item.unlock.some((u) => matches(u, signals)) }));\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singi-labs/sifa-sdk",
-  "version": "0.19.37",
+  "version": "0.19.38",
   "description": "Sifa SDK — public client library for the Sifa AppView on AT Protocol. Shared by sifa-web and sifa-app.",
   "license": "MIT",
   "type": "module",
@@ -172,6 +172,16 @@
         "default": "./dist/jev/index.cjs"
       }
     },
+    "./rpg": {
+      "import": {
+        "types": "./dist/rpg/index.d.ts",
+        "default": "./dist/rpg/index.js"
+      },
+      "require": {
+        "types": "./dist/rpg/index.d.cts",
+        "default": "./dist/rpg/index.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.cjs",