@varla/polymarket 2.2.5 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @varla/polymarket
 
+## 2.3.0
+
+### Minor Changes
+
+- 70422c9: Added Polymarket event URL utilities and enriched resolved market data with event slug and URL fields.
+
+  - export polymarketEventUrl for constructing Polymarket event links,- include eventSlug and url on ResolvedBinaryMarket results using event slug when available
+
+## 2.2.6
+
+### Patch Changes
+
+- f149b83: Apply minor package metadata formatting cleanup without functional changes.
+
+  - Reformat the package files list for consistency
+
 ## 2.2.5
 
 ### Patch Changes

package/dist/index.d.ts

@@ -19,5 +19,6 @@ export * from "./rate-limits.js";
 export { parseDecimalToBigint } from "./utils/decimal.js";
 export { twapFromHistory } from "./utils/twap.js";
 export { probToE8, collateralPriceFromMarkets } from "./utils/pricing.js";
+export { polymarketEventUrl } from "./utils/url.js";
 export * from "./bridge-client.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAMlC,cAAc,gBAAgB,CAAC;AAM/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAM9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAMjC,cAAc,sBAAsB,CAAC;AAMrC,cAAc,UAAU,CAAC;AAMzB,cAAc,kBAAkB,CAAC;AAMjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAM1E,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAMlC,cAAc,gBAAgB,CAAC;AAM/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAM9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAMjC,cAAc,sBAAsB,CAAC;AAMrC,cAAc,UAAU,CAAC;AAMzB,cAAc,kBAAkB,CAAC;AAMjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMpD,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -1584,6 +1584,12 @@ function chunk(xs, size) {
     out.push(xs.slice(i, i + size));
   return out;
 }
+// src/utils/url.ts
+var POLYMARKET_BASE = "https://polymarket.com/event";
+function polymarketEventUrl(slug) {
+  return `${POLYMARKET_BASE}/${encodeURIComponent(slug)}`;
+}
+
 // src/resolver.ts
 function parseJsonStringArray(field, value) {
   const parsed = JSON.parse(value);
@@ -1606,10 +1612,13 @@ function resolveBinaryMarketFromGammaMarket(m) {
   if (yesIdx === -1 || noIdx === -1) {
     throw new Error(`Gamma market ${m.id} outcomes are not Yes/No: ${outcomes.join(",")}`);
   }
+  const eventSlug = m.events?.[0]?.slug;
   return {
     conditionId: m.conditionId,
     gammaMarketId: m.id,
     slug: m.slug,
+    eventSlug,
+    url: polymarketEventUrl(eventSlug ?? m.slug),
     yesTokenId: tokenIds[yesIdx] ?? (() => {
       throw new Error(`Missing YES tokenId for market ${m.id}`);
     })(),
@@ -3283,6 +3292,7 @@ export {
   resetClobClient,
   probToE8,
   priceValid,
+  polymarketEventUrl,
   parseRetryAfter,
   parseDecimalToBigint,
   isValidPrice,

package/dist/resolver.d.ts

@@ -3,7 +3,17 @@ import type { GammaMarket } from "./types.js";
 export type ResolvedBinaryMarket = {
     conditionId: `0x${string}`;
     gammaMarketId: string;
+    /** Market-level slug from Gamma API. */
     slug: string;
+    /** Parent event slug (when the Gamma response includes nested events). */
+    eventSlug?: string;
+    /**
+     * Best-effort Polymarket UI link.
+     * Constructed as `https://polymarket.com/event/<eventSlug ?? slug>`.
+     * Uses the event slug when available (correct for Polymarket routing),
+     * falls back to the market slug otherwise.
+     */
+    url: string;
     yesTokenId: string;
     noTokenId: string;
     endDateIso?: string;

package/dist/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAUF,wBAAgB,kCAAkC,CAAC,CAAC,EAAE,WAAW,GAAG,oBAAoB,CAkCvF;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,CACJ,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,IAAI,CAAC;CACX,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,iCAAiC,CACrD,YAAY,EAAE,KAAK,MAAM,EAAE,EAAE,EAC7B,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CA4BnD"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAUF,wBAAgB,kCAAkC,CAAC,CAAC,EAAE,WAAW,GAAG,oBAAoB,CAsCvF;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,CACJ,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,IAAI,CAAC;CACX,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,iCAAiC,CACrD,YAAY,EAAE,KAAK,MAAM,EAAE,EAAE,EAC7B,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CA4BnD"}

package/dist/utils/url.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Construct a full Polymarket event URL from a Gamma slug.
+ *
+ * @example
+ * ```ts
+ * polymarketEventUrl("will-bitcoin-hit-1m-before-gta-vi")
+ * // => "https://polymarket.com/event/will-bitcoin-hit-1m-before-gta-vi"
+ * ```
+ */
+export declare function polymarketEventUrl(slug: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@varla/polymarket",
-  "version": "2.2.5",
+  "version": "2.3.0",
   "description": "High-performance Polymarket SDK",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,13 +11,7 @@
       "import": "./dist/index.js"
     }
   },
-  "files": [
-    "dist",
-    "README.md",
-    "AGENTS.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
+  "files": ["dist", "README.md", "AGENTS.md", "CHANGELOG.md", "LICENSE"],
   "scripts": {
     "build": "bun build ./src/index.ts --outdir ./dist --target node --format esm",
     "build:types": "bun x tsc --emitDeclarationOnly --declaration --outDir dist || true",