@ewanc26/supporters 0.1.1 → 0.1.2

package/dist/store.d.ts

@@ -11,8 +11,9 @@
  *
  * Required environment variables:
  *   ATPROTO_DID           — your DID, e.g. did:plc:abc123
- *   ATPROTO_PDS_URL       — your PDS URL, e.g. https://pds.ewancroft.uk
  *   ATPROTO_APP_PASSWORD  — an app password from your PDS settings
+ *
+ * The PDS URL is resolved automatically from the DID via Slingshot.
  */
 import type { KofiSupporter, KofiEventType } from './types.js';
 /** The shape of a raw record stored in the PDS. */
@@ -20,6 +21,9 @@ export interface KofiEventRecord {
     name: string;
     type: KofiEventType;
     tier?: string;
+    isSubscriptionPayment?: true;
+    isFirstSubscriptionPayment?: true;
+    shopItems?: string[];
 }
 /**
  * Read all event records from the PDS and aggregate into KofiSupporter objects.
@@ -28,6 +32,11 @@ export interface KofiEventRecord {
 export declare function readStore(): Promise<KofiSupporter[]>;
 /**
  * Write a single Ko-fi event as a new record.
- * rkey is a TID generated at call time.
+ * rkey is a TID generated from the event timestamp.
+ * Timestamp is normalised to UTC before encoding.
  */
-export declare function appendEvent(name: string, type: KofiEventType, tier: string | null, timestamp: string): Promise<void>;
+export declare function appendEvent(name: string, type: KofiEventType, tier: string | null, timestamp: string, opts?: {
+    isSubscriptionPayment?: boolean;
+    isFirstSubscriptionPayment?: boolean;
+    shopItems?: string[];
+}): Promise<void>;

package/dist/store.js

@@ -11,8 +11,9 @@
  *
  * Required environment variables:
  *   ATPROTO_DID           — your DID, e.g. did:plc:abc123
- *   ATPROTO_PDS_URL       — your PDS URL, e.g. https://pds.ewancroft.uk
  *   ATPROTO_APP_PASSWORD  — an app password from your PDS settings
+ *
+ * The PDS URL is resolved automatically from the DID via Slingshot.
  */
 import { AtpAgent } from '@atproto/api';
 import { generateTID } from '@ewanc26/tid';
@@ -26,11 +27,21 @@ function requireEnv(key) {
 function dedupe(arr, extra) {
     return Array.from(new Set([...arr, extra]));
 }
+/** Resolve the PDS URL for a DID via the AT Protocol identity endpoint. */
+async function resolvePdsUrl(did) {
+    const res = await fetch(`https://slingshot.microcosm.blue/xrpc/com.bad-example.identity.resolveMiniDoc?identifier=${encodeURIComponent(did)}`);
+    if (!res.ok)
+        throw new Error(`Failed to resolve PDS for ${did}: ${res.status}`);
+    const data = await res.json();
+    if (!data.pds)
+        throw new Error(`No PDS found in identity document for ${did}`);
+    return data.pds;
+}
 /** Authenticated agent for write operations. */
 async function authedAgent() {
     const did = requireEnv('ATPROTO_DID');
-    const pdsUrl = requireEnv('ATPROTO_PDS_URL');
     const password = requireEnv('ATPROTO_APP_PASSWORD');
+    const pdsUrl = await resolvePdsUrl(did);
     const agent = new AtpAgent({ service: pdsUrl });
     await agent.login({ identifier: did, password });
     return { agent, did };
@@ -41,7 +52,7 @@ async function authedAgent() {
  */
 export async function readStore() {
     const did = requireEnv('ATPROTO_DID');
-    const pdsUrl = requireEnv('ATPROTO_PDS_URL');
+    const pdsUrl = await resolvePdsUrl(did);
     const agent = new AtpAgent({ service: pdsUrl });
     const events = [];
     let cursor;
@@ -76,19 +87,25 @@ function aggregateEvents(events) {
 }
 /**
  * Write a single Ko-fi event as a new record.
- * rkey is a TID generated at call time.
+ * rkey is a TID generated from the event timestamp.
+ * Timestamp is normalised to UTC before encoding.
  */
-export async function appendEvent(name, type, tier, timestamp) {
+export async function appendEvent(name, type, tier, timestamp, opts) {
     const { agent, did } = await authedAgent();
+    // Ko-fi timestamps have no timezone; normalise to UTC
+    const ts = timestamp.endsWith('Z') ? timestamp : timestamp + 'Z';
     const record = {
         name,
         type,
-        ...(tier ? { tier } : {})
+        ...(tier ? { tier } : {}),
+        ...(opts?.isSubscriptionPayment ? { isSubscriptionPayment: true } : {}),
+        ...(opts?.isFirstSubscriptionPayment ? { isFirstSubscriptionPayment: true } : {}),
+        ...(opts?.shopItems?.length ? { shopItems: opts.shopItems } : {})
     };
     await agent.com.atproto.repo.putRecord({
         repo: did,
         collection: COLLECTION,
-        rkey: generateTID(timestamp),
+        rkey: generateTID(ts),
         record: record
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ewanc26/supporters",
-	"version": "0.1.1",
+	"version": "0.1.2",
 	"description": "SvelteKit component library for displaying Ko-fi supporters, backed by an ATProto PDS.",
 	"author": "Ewan Croft",
 	"license": "AGPL-3.0-only",