@hasna/experts 0.0.5 → 0.0.7

package/dist/score.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Authority / relevance scoring — a single composite rank so results aren't
+ * sorted by one axis. Pure and deterministic, so it's easy to test and tune.
+ */
+import type { Expert } from "./types";
+export interface ScoreWeights {
+    rating: number;
+    reviews: number;
+    followers: number;
+    featured: number;
+    verified: number;
+    recency: number;
+}
+export declare const DEFAULT_WEIGHTS: ScoreWeights;
+export interface ScoreInputs {
+    followers?: number;
+    /** Days since most recent tweet (smaller = fresher). */
+    daysSinceLastTweet?: number;
+}
+/**
+ * Composite 0..100 authority score. Combines rating, review volume, social
+ * reach, featured/verified flags, and recency of activity.
+ */
+export declare function authorityScore(e: Expert, inputs?: ScoreInputs, weights?: ScoreWeights): number;
+//# sourceMappingURL=score.d.ts.map

package/dist/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../src/score.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAY,MAAM,SAAS,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,eAAe,EAAE,YAO7B,CAAC;AAMF,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,WAAgB,EAAE,OAAO,GAAE,YAA8B,GAAG,MAAM,CAkBnH"}

package/dist/sdk.d.ts

@@ -6,7 +6,7 @@
  * importing the storage layer. It mirrors the read endpoints exposed by
  * `src/server`.
  */
-import type { Expert, Topic, Tweet, XProfile } from "./types";
+import type { Expert, Topic, Tweet, XProfile, Contact, Video } from "./types";
 export interface ExpertsClientOptions {
     /** Base URL of an `experts-serve` instance. */
     baseUrl?: string;
@@ -38,6 +38,7 @@ export interface RelatedMatch {
 export interface ExpertDetail extends Expert {
     xProfile: XProfile | null;
     tweets: Tweet[];
+    contacts: Contact[];
 }
 /** Minimal, dependency-free client for the open-experts HTTP API. */
 export declare class ExpertsClient {
@@ -62,6 +63,28 @@ export declare class ExpertsClient {
         source?: string;
         limit?: number;
     }): Promise<Expert[]>;
+    /** Natural-language semantic search ("who can help with X"). */
+    ask(query: string, opts?: {
+        source?: string;
+        limit?: number;
+    }): Promise<{
+        expert: Expert;
+        score: number;
+    }[]>;
+    /** Ranked, person-deduplicated shortlist for a problem brief. */
+    brief(text: string, opts?: {
+        source?: string;
+        limit?: number;
+    }): Promise<{
+        expert: Expert;
+        score: number;
+        why: string[];
+    }[]>;
+    persons(): Promise<{
+        experts: number;
+        persons: number;
+        duplicated: number;
+    }>;
     /** Need-based knowledge-graph search. */
     find(needs: string[], opts?: {
         matchAll?: boolean;
@@ -74,6 +97,8 @@ export declare class ExpertsClient {
     get expert(): {
         get: (source: string, idOrSlug: string) => Promise<ExpertDetail>;
         tweets: (source: string, idOrSlug: string, limit?: number) => Promise<Tweet[]>;
+        contacts: (source: string, idOrSlug: string) => Promise<Contact[]>;
+        videos: (source: string, idOrSlug: string, limit?: number) => Promise<Video[]>;
     };
     topics(source?: string): Promise<(Topic & {
         source: string;

package/dist/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC/C,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAa,SAAQ,MAAM;IAC1C,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,qEAAqE;AACrE,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAe;gBAElB,IAAI,GAAE,oBAAyB;YAM7B,GAAG;IAYjB,MAAM;YACkB,OAAO;iBAAW,MAAM;iBAAW,MAAM,EAAE;;IAGnE,OAAO;cACmB,MAAM;qBAAe,MAAM;iBAAW,MAAM;iBAAW,MAAM;;IAGvF,IAAI,CAAC,CAAC,GAAE,SAAc;IAQtB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAIpE,yCAAyC;IACzC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAOxF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAMvE,IAAI,MAAM;sBAEQ,MAAM,YAAY,MAAM;yBAErB,MAAM,YAAY,MAAM,UAAU,MAAM;MAG5D;IAED,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM;gBACe,MAAM;;IAG3C,IAAI,CAAC,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;cACzB,MAAM;eAAS,MAAM;gBAAU,MAAM;;IAG/D,KAAK;eACsB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;eAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;iBAAW,GAAG,EAAE;;IAGhG,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM;IAIrB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM;oBACM,MAAM;kBAAY,MAAM;gBAAU,MAAM;iBAAW,MAAM;;CAE1F"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"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"}

package/dist/sdk.js

@@ -61,6 +61,15 @@ class ExpertsClient {
   search(query, opts = {}) {
     return this.get("/experts", { q: query, source: opts.source, limit: opts.limit });
   }
+  ask(query, opts = {}) {
+    return this.get("/ask", { q: query, source: opts.source, limit: opts.limit });
+  }
+  brief(text, opts = {}) {
+    return this.get("/brief", { q: text, source: opts.source, limit: opts.limit });
+  }
+  persons() {
+    return this.get("/persons");
+  }
   find(needs, opts = {}) {
     return this.get("/find", {
       needs: needs.join(","),
@@ -77,7 +86,9 @@ class ExpertsClient {
   get expert() {
     return {
       get: (source, idOrSlug) => this.get(`/experts/${encodeURIComponent(source)}/${encodeURIComponent(idOrSlug)}`),
-      tweets: (source, idOrSlug, limit) => this.get(`/experts/${encodeURIComponent(source)}/${encodeURIComponent(idOrSlug)}/tweets`, { limit })
+      tweets: (source, idOrSlug, limit) => this.get(`/experts/${encodeURIComponent(source)}/${encodeURIComponent(idOrSlug)}/tweets`, { limit }),
+      contacts: (source, idOrSlug) => this.get(`/experts/${encodeURIComponent(source)}/${encodeURIComponent(idOrSlug)}/contacts`),
+      videos: (source, idOrSlug, limit) => this.get(`/experts/${encodeURIComponent(source)}/${encodeURIComponent(idOrSlug)}/videos`, { limit })
     };
   }
   topics(source) {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,SAAS,EAAmC,MAAM,OAAO,CAAC;AA0BnE,wBAAgB,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,QAAQ,CAmH5D;AAED,wBAAsB,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsBhF;AAED,wBAAgB,WAAW,CAAC,IAAI,SAAO,EAAE,IAAI,SAAS,wBAUrD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,SAAS,EAAmC,MAAM,OAAO,CAAC;AA2BnE,wBAAgB,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,QAAQ,CA6I5D;AAED,wBAAsB,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuDhF;AAED,wBAAgB,WAAW,CAAC,IAAI,SAAO,EAAE,IAAI,SAAS,wBAUrD"}