@keytrace/runner 0.0.3

package/dist/serviceProviders/dns.d.ts

@@ -0,0 +1,10 @@
+import type { ServiceProvider } from "./types.js";
+/**
+ * DNS TXT record service provider
+ *
+ * Users prove domain ownership by adding a TXT record containing their DID.
+ * The claim URI format is: dns:example.com
+ */
+declare const dns: ServiceProvider;
+export default dns;
+//# sourceMappingURL=dns.d.ts.map

package/dist/serviceProviders/dns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns.d.ts","sourceRoot":"","sources":["../../src/serviceProviders/dns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;GAKG;AACH,QAAA,MAAM,GAAG,EAAE,eAgEV,CAAC;AAEF,eAAe,GAAG,CAAC"}

package/dist/serviceProviders/dns.js

@@ -0,0 +1,65 @@
+/**
+ * DNS TXT record service provider
+ *
+ * Users prove domain ownership by adding a TXT record containing their DID.
+ * The claim URI format is: dns:example.com
+ */
+const dns = {
+    id: "dns",
+    name: "Domain",
+    homepage: "",
+    // Match dns:domain.tld URIs (must contain at least one dot)
+    reUri: /^dns:([a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?)+)$/,
+    isAmbiguous: false,
+    ui: {
+        description: "Link via DNS TXT record",
+        icon: "globe",
+        inputLabel: "Domain",
+        inputPlaceholder: "example.com",
+        instructions: [
+            "Open your domain's DNS settings (usually in your registrar or hosting provider)",
+            "Add a new **TXT record** at the root domain (or at `_keytrace.yourdomain.com`)",
+            "Set the record value to the verification content below",
+            "Save and wait for DNS propagation (may take a few minutes to an hour)",
+            "Enter your domain below and verify",
+        ],
+        proofTemplate: "keytrace-verification={did}",
+    },
+    processURI(uri, match) {
+        const [, domain] = match;
+        return {
+            profile: {
+                display: domain,
+                uri: `https://${domain}`,
+            },
+            proof: {
+                request: {
+                    uri: domain,
+                    fetcher: "dns",
+                    format: "json",
+                },
+                target: [
+                    // Look for DID in any TXT record
+                    { path: ["records", "txt"], relation: "contains", format: "text" },
+                ],
+            },
+        };
+    },
+    getProofText(did) {
+        return `keytrace-verification=${did}`;
+    },
+    getProofLocation(match) {
+        const [, domain] = match;
+        return `Add a TXT record at the root of ${domain} (or at _keytrace.${domain})`;
+    },
+    tests: [
+        { uri: "dns:example.com", shouldMatch: true },
+        { uri: "dns:sub.example.com", shouldMatch: true },
+        { uri: "dns:a.b.c.example.com", shouldMatch: true },
+        { uri: "dns:example", shouldMatch: false },
+        { uri: "dns:-invalid.com", shouldMatch: false },
+        { uri: "https://example.com", shouldMatch: false },
+    ],
+};
+export default dns;
+//# sourceMappingURL=dns.js.map

package/dist/serviceProviders/dns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dns.js","sourceRoot":"","sources":["../../src/serviceProviders/dns.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,GAAG,GAAoB;IAC3B,EAAE,EAAE,KAAK;IACT,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,EAAE;IAEZ,4DAA4D;IAC5D,KAAK,EAAE,iGAAiG;IAExG,WAAW,EAAE,KAAK;IAElB,EAAE,EAAE;QACF,WAAW,EAAE,yBAAyB;QACtC,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,QAAQ;QACpB,gBAAgB,EAAE,aAAa;QAC/B,YAAY,EAAE;YACZ,iFAAiF;YACjF,gFAAgF;YAChF,wDAAwD;YACxD,uEAAuE;YACvE,oCAAoC;SACrC;QACD,aAAa,EAAE,6BAA6B;KAC7C;IAED,UAAU,CAAC,GAAG,EAAE,KAAK;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;QAEzB,OAAO;YACL,OAAO,EAAE;gBACP,OAAO,EAAE,MAAM;gBACf,GAAG,EAAE,WAAW,MAAM,EAAE;aACzB;YACD,KAAK,EAAE;gBACL,OAAO,EAAE;oBACP,GAAG,EAAE,MAAM;oBACX,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,MAAM;iBACf;gBACD,MAAM,EAAE;oBACN,iCAAiC;oBACjC,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE;iBACnE;aACF;SACF,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,GAAG;QACd,OAAO,yBAAyB,GAAG,EAAE,CAAC;IACxC,CAAC;IAED,gBAAgB,CAAC,KAAK;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;QACzB,OAAO,mCAAmC,MAAM,qBAAqB,MAAM,GAAG,CAAC;IACjF,CAAC;IAED,KAAK,EAAE;QACL,EAAE,GAAG,EAAE,iBAAiB,EAAE,WAAW,EAAE,IAAI,EAAE;QAC7C,EAAE,GAAG,EAAE,qBAAqB,EAAE,WAAW,EAAE,IAAI,EAAE;QACjD,EAAE,GAAG,EAAE,uBAAuB,EAAE,WAAW,EAAE,IAAI,EAAE;QACnD,EAAE,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,EAAE;QAC1C,EAAE,GAAG,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,EAAE;QAC/C,EAAE,GAAG,EAAE,qBAAqB,EAAE,WAAW,EAAE,KAAK,EAAE;KACnD;CACF,CAAC;AAEF,eAAe,GAAG,CAAC"}

package/dist/serviceProviders/github.d.ts

@@ -0,0 +1,10 @@
+import type { ServiceProvider } from "./types.js";
+/**
+ * GitHub Gist service provider
+ *
+ * Users prove ownership by creating a public gist containing their DID.
+ * The gist URL is used as the claim URI.
+ */
+declare const github: ServiceProvider;
+export default github;
+//# sourceMappingURL=github.d.ts.map

package/dist/serviceProviders/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/serviceProviders/github.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;GAKG;AACH,QAAA,MAAM,MAAM,EAAE,eAqGb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/serviceProviders/github.js

@@ -0,0 +1,100 @@
+/**
+ * GitHub Gist service provider
+ *
+ * Users prove ownership by creating a public gist containing their DID.
+ * The gist URL is used as the claim URI.
+ */
+const github = {
+    id: "github",
+    name: "GitHub",
+    homepage: "https://github.com",
+    // Match GitHub Gist URLs: https://gist.github.com/username/gistid
+    reUri: /^https:\/\/gist\.github\.com\/([^/]+)\/([a-f0-9]+)\/?$/,
+    isAmbiguous: false,
+    ui: {
+        description: "Link via a public gist",
+        icon: "github",
+        inputLabel: "Gist URL",
+        inputPlaceholder: "https://gist.github.com/username/abc123...",
+        instructions: [
+            "Go to [gist.github.com](https://gist.github.com) and create a new gist",
+            "Name the file `keytrace.json` (or `keytrace.md` or `proof.md`)",
+            "Paste the verification content below into the file",
+            "Make sure the gist is **public**, then save it",
+            "Copy the gist URL and paste it below",
+        ],
+        proofTemplate: '{\n  "did": "{did}"\n}',
+    },
+    processURI(uri, match) {
+        const [, username, gistId] = match;
+        return {
+            profile: {
+                display: `@${username}`,
+                uri: `https://github.com/${username}`,
+            },
+            proof: {
+                request: {
+                    uri: `https://api.github.com/gists/${gistId}`,
+                    fetcher: "http",
+                    format: "json",
+                    options: {
+                        headers: {
+                            Accept: "application/vnd.github.v3+json",
+                        },
+                    },
+                },
+                target: [
+                    // Check keytrace.json file content
+                    {
+                        path: ["files", "keytrace.json", "content"],
+                        relation: "contains",
+                        format: "text",
+                    },
+                    // Check proof.md file content
+                    {
+                        path: ["files", "proof.md", "content"],
+                        relation: "contains",
+                        format: "text",
+                    },
+                    // Check keytrace.md file content
+                    {
+                        path: ["files", "keytrace.md", "content"],
+                        relation: "contains",
+                        format: "text",
+                    },
+                    // Check openpgp.md for backwards compatibility with Keyoxide
+                    {
+                        path: ["files", "openpgp.md", "content"],
+                        relation: "contains",
+                        format: "text",
+                    },
+                    // Check gist description
+                    { path: ["description"], relation: "contains", format: "text" },
+                ],
+            },
+        };
+    },
+    postprocess(data, match) {
+        const [, username] = match;
+        const gist = data;
+        return {
+            subject: gist.owner?.login ?? username,
+            avatarUrl: gist.owner?.avatar_url,
+            profileUrl: `https://github.com/${gist.owner?.login ?? username}`,
+        };
+    },
+    getProofText(did) {
+        return `Verifying my identity on keytrace: ${did}`;
+    },
+    getProofLocation() {
+        return `Create a public gist with a file named keytrace.json, keytrace.md, or proof.md containing the proof text`;
+    },
+    tests: [
+        { uri: "https://gist.github.com/alice/abc123def456", shouldMatch: true },
+        { uri: "https://gist.github.com/alice/abc123def456/", shouldMatch: true },
+        { uri: "https://github.com/alice", shouldMatch: false },
+        { uri: "https://gist.gitlab.com/alice/abc123", shouldMatch: false },
+    ],
+};
+export default github;
+//# sourceMappingURL=github.js.map

package/dist/serviceProviders/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/serviceProviders/github.ts"],"names":[],"mappings":"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"}

package/dist/serviceProviders/index.d.ts

@@ -0,0 +1,26 @@
+import github from "./github.js";
+import dns from "./dns.js";
+import activitypub from "./activitypub.js";
+import bsky from "./bsky.js";
+import npm from "./npm.js";
+import type { ServiceProvider, ServiceProviderMatch } from "./types.js";
+export type { ServiceProvider, ServiceProviderMatch, ServiceProviderUI, ProofTarget, ProofRequest, ProcessedURI } from "./types.js";
+/**
+ * Get a service provider by ID
+ */
+export declare function getProvider(id: string): ServiceProvider | undefined;
+/**
+ * Get all registered service providers
+ */
+export declare function getAllProviders(): ServiceProvider[];
+/**
+ * Match a URI against all service providers
+ * Returns all matching providers, with unambiguous matches stopping the search
+ */
+export declare function matchUri(uri: string): ServiceProviderMatch[];
+/**
+ * Get the proof text a user should add to verify a claim
+ */
+export declare function getProofTextForProvider(providerId: string, did: string, handle?: string): string | undefined;
+export { github, dns, activitypub, bsky, npm };
+//# sourceMappingURL=index.d.ts.map

package/dist/serviceProviders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serviceProviders/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAExE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAUpI;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEnE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,eAAe,EAAE,CAEnD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAmB5D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5G;AAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC"}

package/dist/serviceProviders/index.js

@@ -0,0 +1,55 @@
+import github from "./github.js";
+import dns from "./dns.js";
+import activitypub from "./activitypub.js";
+import bsky from "./bsky.js";
+import npm from "./npm.js";
+const providers = {
+    github,
+    dns,
+    activitypub,
+    bsky,
+    npm,
+};
+/**
+ * Get a service provider by ID
+ */
+export function getProvider(id) {
+    return providers[id];
+}
+/**
+ * Get all registered service providers
+ */
+export function getAllProviders() {
+    return Object.values(providers);
+}
+/**
+ * Match a URI against all service providers
+ * Returns all matching providers, with unambiguous matches stopping the search
+ */
+export function matchUri(uri) {
+    const matches = [];
+    for (const provider of Object.values(providers)) {
+        const match = uri.match(provider.reUri);
+        if (match) {
+            matches.push({
+                provider,
+                match,
+                isAmbiguous: provider.isAmbiguous ?? false,
+            });
+            // Stop on unambiguous match
+            if (!provider.isAmbiguous) {
+                break;
+            }
+        }
+    }
+    return matches;
+}
+/**
+ * Get the proof text a user should add to verify a claim
+ */
+export function getProofTextForProvider(providerId, did, handle) {
+    const provider = providers[providerId];
+    return provider?.getProofText(did, handle);
+}
+export { github, dns, activitypub, bsky, npm };
+//# sourceMappingURL=index.js.map

package/dist/serviceProviders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serviceProviders/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,GAAG,MAAM,UAAU,CAAC;AAK3B,MAAM,SAAS,GAAoC;IACjD,MAAM;IACN,GAAG;IACH,WAAW;IACX,IAAI;IACJ,GAAG;CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC;gBACX,QAAQ;gBACR,KAAK;gBACL,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,KAAK;aAC3C,CAAC,CAAC;YACH,4BAA4B;YAC5B,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC1B,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAkB,EAAE,GAAW,EAAE,MAAe;IACtF,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACvC,OAAO,QAAQ,EAAE,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC"}

package/dist/serviceProviders/npm.d.ts

@@ -0,0 +1,10 @@
+import type { ServiceProvider } from "./types.js";
+/**
+ * npm service provider
+ *
+ * Users prove ownership by publishing an npm package named keytrace-[handle]
+ * containing their DID in the package.json keytrace field.
+ */
+declare const npm: ServiceProvider;
+export default npm;
+//# sourceMappingURL=npm.d.ts.map

package/dist/serviceProviders/npm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.d.ts","sourceRoot":"","sources":["../../src/serviceProviders/npm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAWlD;;;;;GAKG;AACH,QAAA,MAAM,GAAG,EAAE,eAgGV,CAAC;AAEF,eAAe,GAAG,CAAC"}

package/dist/serviceProviders/npm.js

@@ -0,0 +1,99 @@
+/**
+ * Slugify a handle for use in npm package names.
+ * Replaces dots with dashes since npm doesn't allow dots.
+ * e.g. "orta.io" -> "orta-io"
+ */
+function slugifyHandle(handle) {
+    return handle.replace(/\./g, "-").toLowerCase();
+}
+/**
+ * npm service provider
+ *
+ * Users prove ownership by publishing an npm package named keytrace-[handle]
+ * containing their DID in the package.json keytrace field.
+ */
+const npm = {
+    id: "npm",
+    name: "npm",
+    homepage: "https://www.npmjs.com",
+    // Match npm package URLs: https://www.npmjs.com/package/keytrace-username
+    reUri: /^https:\/\/(?:www\.)?npmjs\.com\/package\/(keytrace-[a-z0-9_-]+)\/?$/i,
+    isAmbiguous: false,
+    ui: {
+        description: "Link via an npm package",
+        icon: "npm",
+        inputLabel: "npm Package URL",
+        inputPlaceholder: "https://www.npmjs.com/package/keytrace-yourhandle",
+        inputDefaultTemplate: "https://www.npmjs.com/package/keytrace-{slugHandle}",
+        instructions: [
+            "Create a new folder with a `package.json` containing the verification content below",
+            "Run `npm publish --access public` to publish",
+            "Paste the npm package URL below",
+        ],
+        proofTemplate: `{
+  "name": "keytrace-{slugHandle}",
+  "version": "0.0.1",
+  "keytrace": "{claimId}",
+  "did": "{did}"
+}`,
+    },
+    processURI(uri, match) {
+        const [, packageName] = match;
+        // Extract the handle from keytrace-handle
+        const handle = packageName.replace(/^keytrace-/i, "");
+        return {
+            profile: {
+                display: `~${handle}`,
+                uri: `https://www.npmjs.com/~${handle}`,
+            },
+            proof: {
+                request: {
+                    // Use npm registry to get the packument with full metadata
+                    uri: `https://registry.npmjs.org/${packageName}`,
+                    fetcher: "http",
+                    format: "json",
+                },
+                target: [
+                    // Check for DID in the did field of any version
+                    // The packument has versions as an object: { versions: { "0.0.1": { did: "did:...", keytrace: "..." } } }
+                    {
+                        path: ["versions", "*", "did"],
+                        relation: "contains",
+                        format: "text",
+                    },
+                ],
+            },
+        };
+    },
+    postprocess(data, _match) {
+        const packument = data;
+        // Get the first maintainer's npm username
+        const maintainer = packument.maintainers?.[0];
+        const npmUsername = maintainer?.name;
+        return {
+            subject: npmUsername,
+            profileUrl: npmUsername ? `https://www.npmjs.com/~${npmUsername}` : undefined,
+        };
+    },
+    getProofText(did, handle) {
+        const slug = handle ? slugifyHandle(handle) : "[your-handle]";
+        return `{
+  "name": "keytrace-${slug}",
+  "version": "0.0.1",
+  "keytrace": "[claim-id]",
+  "did": "${did}"
+}`;
+    },
+    getProofLocation() {
+        return `Publish an npm package named keytrace-[your-handle] with your DID in the keytrace field of package.json`;
+    },
+    tests: [
+        { uri: "https://www.npmjs.com/package/keytrace-alice", shouldMatch: true },
+        { uri: "https://npmjs.com/package/keytrace-alice", shouldMatch: true },
+        { uri: "https://www.npmjs.com/package/keytrace-alice/", shouldMatch: true },
+        { uri: "https://www.npmjs.com/package/some-other-pkg", shouldMatch: false },
+        { uri: "https://www.npmjs.com/~alice", shouldMatch: false },
+    ],
+};
+export default npm;
+//# sourceMappingURL=npm.js.map

package/dist/serviceProviders/npm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.js","sourceRoot":"","sources":["../../src/serviceProviders/npm.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,SAAS,aAAa,CAAC,MAAc;IACnC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,GAAG,GAAoB;IAC3B,EAAE,EAAE,KAAK;IACT,IAAI,EAAE,KAAK;IACX,QAAQ,EAAE,uBAAuB;IAEjC,0EAA0E;IAC1E,KAAK,EAAE,uEAAuE;IAE9E,WAAW,EAAE,KAAK;IAElB,EAAE,EAAE;QACF,WAAW,EAAE,yBAAyB;QACtC,IAAI,EAAE,KAAK;QACX,UAAU,EAAE,iBAAiB;QAC7B,gBAAgB,EAAE,mDAAmD;QACrE,oBAAoB,EAAE,qDAAqD;QAC3E,YAAY,EAAE;YACZ,qFAAqF;YACrF,8CAA8C;YAC9C,iCAAiC;SAClC;QACD,aAAa,EAAE;;;;;EAKjB;KACC;IAED,UAAU,CAAC,GAAG,EAAE,KAAK;QACnB,MAAM,CAAC,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC;QAC9B,0CAA0C;QAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAEtD,OAAO;YACL,OAAO,EAAE;gBACP,OAAO,EAAE,IAAI,MAAM,EAAE;gBACrB,GAAG,EAAE,0BAA0B,MAAM,EAAE;aACxC;YACD,KAAK,EAAE;gBACL,OAAO,EAAE;oBACP,2DAA2D;oBAC3D,GAAG,EAAE,8BAA8B,WAAW,EAAE;oBAChD,OAAO,EAAE,MAAM;oBACf,MAAM,EAAE,MAAM;iBACf;gBACD,MAAM,EAAE;oBACN,gDAAgD;oBAChD,0GAA0G;oBAC1G;wBACE,IAAI,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC;wBAC9B,QAAQ,EAAE,UAAU;wBACpB,MAAM,EAAE,MAAM;qBACf;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,WAAW,CAAC,IAAI,EAAE,MAAM;QACtB,MAAM,SAAS,GAAG,IAGjB,CAAC;QAEF,0CAA0C;QAC1C,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAG,UAAU,EAAE,IAAI,CAAC;QAErC,OAAO;YACL,OAAO,EAAE,WAAW;YACpB,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,0BAA0B,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;SAC9E,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,GAAG,EAAE,MAAM;QACtB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;QAC9D,OAAO;sBACW,IAAI;;;YAGd,GAAG;EACb,CAAC;IACD,CAAC;IAED,gBAAgB;QACd,OAAO,yGAAyG,CAAC;IACnH,CAAC;IAED,KAAK,EAAE;QACL,EAAE,GAAG,EAAE,8CAA8C,EAAE,WAAW,EAAE,IAAI,EAAE;QAC1E,EAAE,GAAG,EAAE,0CAA0C,EAAE,WAAW,EAAE,IAAI,EAAE;QACtE,EAAE,GAAG,EAAE,+CAA+C,EAAE,WAAW,EAAE,IAAI,EAAE;QAC3E,EAAE,GAAG,EAAE,8CAA8C,EAAE,WAAW,EAAE,KAAK,EAAE;QAC3E,EAAE,GAAG,EAAE,8BAA8B,EAAE,WAAW,EAAE,KAAK,EAAE;KAC5D;CACF,CAAC;AAEF,eAAe,GAAG,CAAC"}

package/dist/serviceProviders/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * A match between a URI and a service provider
+ */
+export interface ServiceProviderMatch {
+    provider: ServiceProvider;
+    match: RegExpMatchArray;
+    isAmbiguous: boolean;
+}
+/**
+ * Where to look for proof in the fetched response
+ */
+export interface ProofTarget {
+    /** JSON path to search for proof (e.g., ['description'], ['files', '*', 'content']) */
+    path: string[];
+    /** How to match: 'contains', 'equals', 'startsWith' */
+    relation: "contains" | "equals" | "startsWith";
+    /** Format of data at path */
+    format: "text" | "uri" | "json";
+}
+/**
+ * How to fetch the proof
+ */
+export interface ProofRequest {
+    /** URL template with {placeholders} */
+    uri: string;
+    /** Fetcher to use: 'http', 'dns', 'activitypub' */
+    fetcher: string;
+    /** Expected response format */
+    format: "json" | "text";
+    /** Additional fetch options */
+    options?: {
+        headers?: Record<string, string>;
+    };
+}
+/**
+ * Result of processing a URI
+ */
+export interface ProcessedURI {
+    /** Profile display info */
+    profile: {
+        /** Display name for the identity (e.g., username, domain) */
+        display: string;
+        /** URL to the identity's profile page */
+        uri: string;
+    };
+    /** How to fetch and verify the proof */
+    proof: {
+        request: ProofRequest;
+        target: ProofTarget[];
+    };
+}
+/**
+ * UI configuration for the add claim wizard
+ */
+export interface ServiceProviderUI {
+    /** Short description for service picker (e.g., "Link via a public gist") */
+    description: string;
+    /** Lucide icon name (e.g., "github", "globe") */
+    icon: string;
+    /** Label for the claim URI input field */
+    inputLabel: string;
+    /** Placeholder text for the claim URI input */
+    inputPlaceholder: string;
+    /** Default value template for input. Supports {did}, {handle}, {slugHandle} placeholders */
+    inputDefaultTemplate?: string;
+    /** Step-by-step instructions (markdown supported) */
+    instructions: string[];
+    /** Template for proof content. Supports {did} and {handle} placeholders */
+    proofTemplate: string;
+}
+/**
+ * A service provider that can verify identity claims
+ */
+export interface ServiceProvider {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Homepage URL */
+    homepage: string;
+    /** Regex to match claim URIs */
+    reUri: RegExp;
+    /** Whether matches are potentially ambiguous (could match multiple providers) */
+    isAmbiguous?: boolean;
+    /** UI configuration for the add claim wizard */
+    ui: ServiceProviderUI;
+    /** Process matched URI into verification config */
+    processURI(uri: string, match: RegExpMatchArray): ProcessedURI;
+    /** Optional post-processing after fetch to extract identity metadata */
+    postprocess?(data: unknown, match: RegExpMatchArray): {
+        subject?: string;
+        avatarUrl?: string;
+        profileUrl?: string;
+        displayName?: string;
+    };
+    /** Generate proof text for user to add to their profile */
+    getProofText(did: string, handle?: string): string;
+    /** Human-readable instructions for where to place the proof */
+    getProofLocation?(match: RegExpMatchArray): string;
+    /** Test cases for validation */
+    tests: {
+        uri: string;
+        shouldMatch: boolean;
+    }[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/serviceProviders/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/serviceProviders/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,gBAAgB,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uFAAuF;IACvF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,uDAAuD;IACvD,QAAQ,EAAE,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC/C,6BAA6B;IAC7B,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,+BAA+B;IAC/B,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,OAAO,EAAE;QACP,6DAA6D;QAC7D,OAAO,EAAE,MAAM,CAAC;QAChB,yCAAyC;QACzC,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,wCAAwC;IACxC,KAAK,EAAE;QACL,OAAO,EAAE,YAAY,CAAC;QACtB,MAAM,EAAE,WAAW,EAAE,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,4FAA4F;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qDAAqD;IACrD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IAEd,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,gDAAgD;IAChD,EAAE,EAAE,iBAAiB,CAAC;IAEtB,mDAAmD;IACnD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,YAAY,CAAC;IAE/D,wEAAwE;IACxE,WAAW,CAAC,CACV,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,gBAAgB,GACtB;QACD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,2DAA2D;IAC3D,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnD,+DAA+D;IAC/D,gBAAgB,CAAC,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAEnD,gCAAgC;IAChC,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,EAAE,OAAO,CAAC;KACtB,EAAE,CAAC;CACL"}

package/dist/serviceProviders/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/serviceProviders/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/serviceProviders/types.ts"],"names":[],"mappings":""}