puntersedge 0.1.0 → 1.0.1

package/dist/cjs/client.js

@@ -0,0 +1,502 @@
+"use strict";
+/**
+ * The PuntersEdge client.
+ *
+ * Endpoints are grouped the way the API groups them, because the split is real and getting it
+ * wrong is the single most common first mistake against this API: **racing is not a sport key.**
+ * There is no `sport_key` of `"horse-racing"`. Thoroughbred, greyhound and harness live under
+ * `pe.racing.*`; AFL, NRL, NBA and the rest live under `pe.sports.*`.
+ *
+ *   pe.racing.*      thoroughbred, greyhound and harness — AU and NZ
+ *   pe.sports.*      Australian sports odds by sport key
+ *   pe.arb.*         cross-book price comparison and arbitrage scanning
+ *   pe.account.*     usage, key metadata, rotation, billing portal
+ *   pe.webhooks.*    push delivery instead of polling
+ *   pe.health.*      per-connector freshness and public uptime
+ *   pe.demo.*        the sandbox: real prices, truncated, no key, no credits
+ *
+ * Option names are camelCase and map to the API's snake_case query parameters. Two parameters
+ * are camelCase on the wire too (`oddsFormat`, `maxAgeMinutes`); those pass through untouched.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PuntersEdge = exports.DEFAULT_BASE_URL = exports.VERSION = void 0;
+const http_js_1 = require("./http.js");
+exports.VERSION = "1.0.1";
+/** Default base URL. The API is also reachable at `https://puntersedge.online/api`. */
+exports.DEFAULT_BASE_URL = "https://api.puntersedge.online";
+/**
+ * These go over the wire camelCase. Every other option key is converted to snake_case, so
+ * `numRaces` becomes `num_races` — but `oddsFormat` must NOT become `odds_format`, which the
+ * server would ignore, silently returning decimal odds to a caller who asked for American.
+ */
+const WIRE_CAMEL = new Set(["oddsFormat", "maxAgeMinutes"]);
+function toWireKey(key) {
+    if (WIRE_CAMEL.has(key))
+        return key;
+    return key.replace(/[A-Z]/g, (c) => "_" + c.toLowerCase());
+}
+/**
+ * camelCase options object -> the query object the transport serialises.
+ *
+ * Takes `object` rather than `Record<string, unknown>`: a TypeScript interface without an index
+ * signature is not assignable to `Record`, and every options type in this file is an interface.
+ */
+function q(options) {
+    if (!options)
+        return undefined;
+    const out = {};
+    for (const [key, value] of Object.entries(options)) {
+        if (value === undefined || value === null)
+            continue;
+        out[toWireKey(key)] = value;
+    }
+    return out;
+}
+/** Split a caller's options object into API parameters and per-request transport options. */
+function split(options) {
+    if (!options)
+        return { params: undefined, request: {} };
+    const { signal, timeoutMs, headers, ...rest } = options;
+    return { params: q(rest), request: { signal, timeoutMs, headers } };
+}
+/**
+ * Thoroughbred and greyhound form, and the paced bulk backfill queue.
+ *
+ * Form is collected from Racing Australia and Topaz on a deliberate pace — the upstream rate-
+ * limits hard, and a burst gets the whole estate flagged. `backfill` is the supported way to ask
+ * for many horses: you submit a batch, the queue collects them at a sustainable rate, and you
+ * collect the results when they land. Looping `form()` over 400 horses is the unsupported way.
+ */
+class HorsesAPI {
+    pe;
+    constructor(pe) {
+        this.pe = pe;
+    }
+    /** Form, career record and profile for one horse. 3 credits. */
+    form(horse, options) {
+        return this.pe.get("/v1/racing/horses/form", { horse, ...options });
+    }
+    /** Queue a batch of horses for paced form collection. 3 credits. */
+    submitBackfill(body, options) {
+        return this.pe.post("/v1/racing/horses/backfill", body, options);
+    }
+    /** Progress of a backfill job. 3 credits. */
+    backfillStatus(jobId, options) {
+        return this.pe.get(`/v1/racing/horses/backfill/${encodeURIComponent(jobId)}`, options);
+    }
+    /** Collect the form of the horses this job has delivered so far. 3 credits. */
+    backfillResults(jobId, options) {
+        return this.pe.get(`/v1/racing/horses/backfill/${encodeURIComponent(jobId)}/results`, options);
+    }
+    /** Cancel the horses a job has not collected yet. Free. */
+    cancelBackfill(jobId, options) {
+        return this.pe.delete(`/v1/racing/horses/backfill/${encodeURIComponent(jobId)}`, options);
+    }
+}
+class GreyhoundsAPI {
+    pe;
+    constructor(pe) {
+        this.pe = pe;
+    }
+    /**
+     * Form history for one dog. 3 credits.
+     * `dog` is a name or a Topaz dogId; names match case- and punctuation-insensitively.
+     */
+    form(dog, options) {
+        return this.pe.get("/v1/racing/greyhounds/form", { dog, ...options });
+    }
+    /**
+     * Record by track, distance, box or grade. 3 credits.
+     * `by` crosses dimensions: `["track", "distance"]` groups by both.
+     */
+    stats(dog, options) {
+        return this.pe.get("/v1/racing/greyhounds/stats", { dog, ...options });
+    }
+}
+/** Thoroughbred, greyhound and harness racing across Australia and New Zealand. */
+class RacingAPI {
+    horses;
+    greyhounds;
+    // Assigned in the body rather than as field initializers: under ES2022 class fields, field
+    // initializers run BEFORE a constructor parameter property is assigned, so `new
+    // HorsesAPI(this.pe)` in an initializer would hand it `undefined`.
+    pe;
+    constructor(pe) {
+        this.pe = pe;
+        this.horses = new HorsesAPI(pe);
+        this.greyhounds = new GreyhoundsAPI(pe);
+    }
+    /**
+     * Races about to jump, with runners and live per-bookmaker prices. 2 credits.
+     * The usual starting point. Each quote carries its own `age_seconds` and `stale` flag —
+     * read them, because a stalled scraper keeps serving its last value.
+     */
+    nextToGo(options) {
+        return this.pe.get("/v1/racing/next-to-go", options);
+    }
+    /** Scheduled races in a forward window, without prices. 1 credit. */
+    events(options) {
+        return this.pe.get("/v1/racing/events", options);
+    }
+    /** Best win, place and tote price per runner across books, with the book offering it. 3 credits. */
+    bestOdds(options) {
+        return this.pe.get("/v1/racing/best-odds", options);
+    }
+    /** Consensus steamers and drifters in the live window. 3 credits. */
+    movers(options) {
+        return this.pe.get("/v1/racing/movers", options);
+    }
+    /** Settled results: placings, settled prices, dividends and scratchings. 2 credits. */
+    results(options) {
+        return this.pe.get("/v1/racing/results", options);
+    }
+    /** What the results field coverage actually is, measured rather than promised. 1 credit. */
+    resultsCoverage(options) {
+        return this.pe.get("/v1/racing/results/coverage", options);
+    }
+    /** Per-bookmaker price ticks for one race. 5 credits. */
+    priceHistory(options) {
+        return this.pe.get("/v1/racing/price-history", options);
+    }
+    /**
+     * Races and prices that changed since a timestamp. 2 credits.
+     *
+     * This is the endpoint to build a live board on. Polling `nextToGo` in a loop re-downloads
+     * every race every time and bills you 2 credits for the privilege; `changes` returns only
+     * what moved, and hands back the cursor for the next call.
+     */
+    changes(options) {
+        return this.pe.get("/v1/racing/changes", options);
+    }
+    /**
+     * The permanent closing-line and result archive. **5 credits.** Standard plan and above.
+     *
+     * See `closingLinesCsv` for the bulk form, which costs 20 — the archive endpoints are the
+     * only two on the API whose price depends on the format you ask for.
+     */
+    closingLines(options) {
+        return this.pe.get("/v1/racing/closing-lines", options);
+    }
+    /** What the closing-line archive actually holds — its floor date, row count and coverage. 1 credit. */
+    closingLinesCoverage(options) {
+        return this.pe.get("/v1/racing/closing-lines/coverage", options);
+    }
+    /**
+     * Bulk export of the permanent price-movement archive. **5 credits.** Standard plan and
+     * above. The CSV form (`pricePathsCsv`) costs 20.
+     */
+    pricePaths(options) {
+        return this.pe.get("/v1/racing/price-paths", options);
+    }
+    /** Canonical venue directory: `venue_id`, display name and physical site. 1 credit. */
+    venues(options) {
+        return this.pe.get("/v1/racing/venues", options);
+    }
+    /**
+     * Full-day AU thoroughbred acceptance card. 2 credits.
+     *
+     * Read `completeness` and each race's `runner_set_status` before treating a count as the
+     * field size — the response is explicit about when a figure is a floor rather than exact.
+     */
+    acceptances(options) {
+        return this.pe.get("/v1/racing/acceptances", options);
+    }
+    /** Track condition, weather and rail: current state and the day's change log. 1 credit. */
+    trackConditions(options) {
+        return this.pe.get("/v1/racing/track-conditions", options);
+    }
+    /** Jockey premiership leaderboards, or one jockey by name. 2 credits. */
+    jockeyStats(options) {
+        return this.pe.get("/v1/racing/jockeys/stats", options);
+    }
+    /** Trainer premiership leaderboards, or one trainer by name. 2 credits. */
+    trainerStats(options) {
+        return this.pe.get("/v1/racing/trainers/stats", options);
+    }
+    /**
+     * The closing-line archive as a CSV string, streamed by the server in a stable column order.
+     *
+     * **20 credits, not 5.** This is `closingLines` with `format=csv`, and CSV is priced as the
+     * bulk export it is: the server caps a CSV pull at 50,000 rows against 5,000 for a JSON
+     * page, so one call can return ten times the data. Same filters, four times the price.
+     */
+    closingLinesCsv(options) {
+        return this.pe.get("/v1/racing/closing-lines", { ...options, format: "csv" }, { Accept: "text/csv" });
+    }
+    /**
+     * The price-path archive as a CSV string, in a stable column order.
+     *
+     * **20 credits, not 5** — same bulk-export pricing as `closingLinesCsv`.
+     */
+    pricePathsCsv(options) {
+        return this.pe.get("/v1/racing/price-paths", { ...options, format: "csv" }, { Accept: "text/csv" });
+    }
+}
+/** Australian sports odds. Racing is NOT here — see `pe.racing`. */
+class SportsAPI {
+    pe;
+    constructor(pe) {
+        this.pe = pe;
+    }
+    /** The sport catalogue: every queryable `sport_key` with its display name. 1 credit. */
+    list(options) {
+        return this.pe.get("/v1/sports", options);
+    }
+    /**
+     * Odds for one sport. **1 credit per market requested** — asking for
+     * `["h2h", "spreads", "totals"]` costs 3, not 1.
+     */
+    odds(sportKey, options) {
+        return this.pe.get(`/v1/sports/${encodeURIComponent(sportKey)}/odds`, options);
+    }
+    /** Best available price per outcome across bookmakers, for one sport. 3 credits. */
+    bestOdds(sportKey, options) {
+        return this.pe.get(`/v1/best-odds/${encodeURIComponent(sportKey)}`, options);
+    }
+    /** Historical odds snapshots. 5 credits. */
+    oddsHistory(sportKey, options) {
+        return this.pe.get(`/v1/sports/${encodeURIComponent(sportKey)}/odds/history`, options);
+    }
+    /** Price movement feed for one sport. 5 credits. */
+    oddsMovements(sportKey, options) {
+        return this.pe.get(`/v1/sports/${encodeURIComponent(sportKey)}/odds/movements`, options);
+    }
+}
+/**
+ * Cross-book comparison and arbitrage scanning.
+ *
+ * A word of warning that costs nothing to read: a two-outcome market that only one book is
+ * quoting will look like a large arb and is not one. Check how many books are behind each leg
+ * before acting on a number from here.
+ */
+class ArbAPI {
+    pe;
+    constructor(pe) {
+        this.pe = pe;
+    }
+    /** Head-to-head arb scanner. 3 credits. */
+    sports(options) {
+        return this.pe.get("/v1/arb/sports", options);
+    }
+    /** Spreads and totals line arb. 3 credits. */
+    lines(options) {
+        return this.pe.get("/v1/arb/lines", options);
+    }
+    /** Best price per selection with every book's quote alongside. 2 credits. */
+    bestPrices(options) {
+        return this.pe.get("/v1/arb/best-prices", options);
+    }
+}
+// ── account ───────────────────────────────────────────────────────────────────────────────
+/** Usage, key metadata and billing. Every method here is free — it costs no credits to ask. */
+class AccountAPI {
+    pe;
+    constructor(pe) {
+        this.pe = pe;
+    }
+    /**
+     * Plan, allowance, credits used and reset date. Free.
+     *
+     * You rarely need this: every billed response already carries the balance in its headers,
+     * which the client exposes as `pe.credits`.
+     */
+    usage(options) {
+        return this.pe.get("/v1/usage", options);
+    }
+    /** Usage broken down by endpoint. Free. */
+    usageAnalytics(options) {
+        return this.pe.get("/v1/usage/analytics", options);
+    }
+    /** Plan, limits and status for the key in use. Free. */
+    keyInfo(options) {
+        return this.pe.get("/v1/keys/info", options);
+    }
+    /** A Stripe self-service billing portal link. Free. */
+    billingPortal(options) {
+        return this.pe.get("/v1/billing/portal", options);
+    }
+    /**
+     * Rotate the key. Free.
+     *
+     * The old key keeps working through a grace window so a deploy can roll. Pass
+     * `{ immediate: true }` only when rotating because the key leaked — that revokes it now and
+     * will break anything still holding it.
+     */
+    rotateKey(options) {
+        const { params, request } = split(options);
+        return this.pe.raw("POST", "/v1/keys/rotate", params, undefined, request)
+            .then((r) => r.data);
+    }
+    /** Restrict this key to a set of source IPs. Free. Pass `[]` to clear the whitelist. */
+    setIpWhitelist(ips, options) {
+        const { request } = split(options);
+        return this.pe.raw("POST", "/v1/keys/ip-whitelist", undefined, ips, request)
+            .then((r) => r.data);
+    }
+}
+/**
+ * Push delivery instead of polling. Creating a webhook needs the Standard plan or above.
+ *
+ * Every delivery is signed: `X-Webhook-Signature` is an HMAC-SHA256 over the **raw request
+ * body**, keyed with the secret returned when you create the subscription. Verify it against
+ * the bytes you received, before parsing — re-serialising the JSON first changes the bytes and
+ * the signature will never match.
+ */
+class WebhooksAPI {
+    pe;
+    constructor(pe) {
+        this.pe = pe;
+    }
+    /** Create a subscription. The response carries the signing secret — it is shown once. */
+    create(input, options) {
+        return this.pe.post("/v1/webhooks", input, options);
+    }
+    list(options) {
+        return this.pe.get("/v1/webhooks", options);
+    }
+    delete(webhookId, options) {
+        return this.pe.delete(`/v1/webhooks/${encodeURIComponent(webhookId)}`, options);
+    }
+    /** Recent delivery attempts, with response codes — the first place to look when nothing arrives. */
+    deliveries(webhookId, options) {
+        return this.pe.get(`/v1/webhooks/${encodeURIComponent(webhookId)}/deliveries`, options);
+    }
+    /** Fire a test delivery at the endpoint, so you can verify your signature check end to end. */
+    test(webhookId, options) {
+        return this.pe.post(`/v1/webhooks/${encodeURIComponent(webhookId)}/test`, undefined, options);
+    }
+}
+// ── health ────────────────────────────────────────────────────────────────────────────────
+/**
+ * Is the data current?
+ *
+ * `connectors()` is the one to watch. A stalled scraper does not return an error — it keeps
+ * serving its last value, which is exactly what a live price looks like. `last_ok` per
+ * connector is how you tell the difference.
+ */
+class HealthAPI {
+    pe;
+    constructor(pe) {
+        this.pe = pe;
+    }
+    /** Per-connector freshness: `last_ok`, status, records written. Requires a key. */
+    connectors(options) {
+        return this.pe.get("/v1/health", options);
+    }
+    /** Per-connector freshness with tunable staleness thresholds and optional per-sport coverage. 1 credit. */
+    connectorDetail(options) {
+        return this.pe.get("/v1/health/connectors", options);
+    }
+    /** Public uptime stats. No key, no credits. */
+    uptime(options) {
+        return this.pe.get("/v1/uptime", options);
+    }
+}
+// ── sandbox ───────────────────────────────────────────────────────────────────────────────
+/**
+ * The sandbox: real prices, truncated to 3 races, 5 runners and 3 bookmakers. No key, no
+ * credits. Use it to learn the response shape before you spend anything, and to keep an
+ * example in your README runnable by someone who has not signed up yet.
+ */
+class DemoAPI {
+    pe;
+    constructor(pe) {
+        this.pe = pe;
+    }
+    nextToGo(options) {
+        return this.pe.get("/v1/demo/racing/next-to-go", options);
+    }
+    /** Sample best-odds with arb detection. `sport` is optional; a live sport is picked if omitted. */
+    bestOdds(options) {
+        return this.pe.get("/v1/demo/best-odds", options);
+    }
+}
+/**
+ * ```ts
+ * import { PuntersEdge } from "puntersedge";
+ *
+ * const pe = new PuntersEdge({ apiKey: process.env.PUNTERSEDGE_API_KEY });
+ *
+ * for (const race of await pe.racing.nextToGo({ numRaces: 5, categories: "horse" })) {
+ *   console.log(race.venue, race.race_number, race.start_time);
+ * }
+ *
+ * console.log(pe.credits?.remaining, "credits left");
+ * ```
+ */
+class PuntersEdge {
+    racing = new RacingAPI(this);
+    sports = new SportsAPI(this);
+    arb = new ArbAPI(this);
+    account = new AccountAPI(this);
+    webhooks = new WebhooksAPI(this);
+    health = new HealthAPI(this);
+    demo = new DemoAPI(this);
+    /**
+     * Credit accounting from the most recent billed response — balance, cost, and the upgrade
+     * recommendation once you cross the warning threshold. Undefined until the first billed call.
+     */
+    credits;
+    // A true #private field, not TypeScript's compile-time `private`. TS `private` is erased,
+    // leaving an ordinary enumerable property — so `console.log(pe)` would print the API key,
+    // and so would any error reporter that serialises the object. `#config` is unreachable from
+    // outside the class and invisible to enumeration.
+    #config;
+    constructor(options = {}) {
+        const opts = typeof options === "string" ? { apiKey: options } : options;
+        const base = (opts.baseUrl ?? exports.DEFAULT_BASE_URL).replace(/\/+$/, "");
+        const ua = opts.userAgent
+            ? `puntersedge-node/${exports.VERSION} ${opts.userAgent}`
+            : `puntersedge-node/${exports.VERSION}`;
+        const fetchImpl = opts.fetch ?? globalThis.fetch;
+        if (typeof fetchImpl !== "function") {
+            throw new Error("No global fetch. Use Node 18 or later, or pass one: new PuntersEdge({ fetch }).");
+        }
+        this.#config = {
+            baseUrl: base,
+            apiKey: opts.apiKey,
+            timeoutMs: opts.timeoutMs ?? 30_000,
+            userAgent: ua,
+            // Bound: some runtimes throw "Illegal invocation" on a detached global fetch.
+            fetch: fetchImpl.bind(globalThis),
+            onCredits: (credits) => {
+                this.credits = credits;
+                opts.onCredits?.(credits);
+            },
+        };
+    }
+    /**
+     * The full response for one call: data, credits and headers together.
+     *
+     * ```ts
+     * const { data, credits } = await pe.withCredits((p) => p.racing.nextToGo());
+     * ```
+     */
+    async withCredits(call) {
+        const data = await call(this);
+        return { data, credits: this.credits };
+    }
+    /** Escape hatch: any endpoint, including ones added after this SDK was published. */
+    async raw(method, path, params, body, options = {}) {
+        return (0, http_js_1.request)(this.#config, method, path, params, body, options);
+    }
+    /** @internal */
+    get(path, options, extraHeaders) {
+        const { params, request: req } = split(options);
+        if (extraHeaders)
+            req.headers = { ...extraHeaders, ...req.headers };
+        return this.raw("GET", path, params, undefined, req).then((r) => r.data);
+    }
+    /** @internal */
+    post(path, body, options) {
+        const { request: req } = split(options);
+        return this.raw("POST", path, undefined, body, req).then((r) => r.data);
+    }
+    /** @internal */
+    delete(path, options) {
+        const { request: req } = split(options);
+        return this.raw("DELETE", path, undefined, undefined, req).then((r) => r.data);
+    }
+}
+exports.PuntersEdge = PuntersEdge;
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

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

package/dist/cjs/credits.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Credit accounting, read off the headers of the response you already made.
+ *
+ * WHY THIS EXISTS. The API bills per successful request and reports the running balance on
+ * every single response — `X-Credits-Remaining`, plus a `X-Credits-Warning` once you cross the
+ * warning threshold and an `X-Upgrade-*` block telling you exactly what to buy and how. Polling
+ * `/v1/usage` to learn the same thing is a round-trip that answers a question the last response
+ * already answered.
+ *
+ * So the client parses the headers on every call and hands them to you three ways:
+ *
+ *   client.credits                       // the most recent snapshot, or undefined
+ *   new PuntersEdge({ onCredits })       // a callback fired after every billed call
+ *   await client.withCredits(c => ...)   // data and credits together for one call
+ *
+ * `remaining` and `limit` are `"unlimited"` on an unlimited plan rather than a number, because
+ * that is what the header says and coercing it to `Infinity` would let `remaining < 100` quietly
+ * mean something different on two plans.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseUpgrade = parseUpgrade;
+exports.parseCredits = parseCredits;
+function num(h, name) {
+    const v = h.get(name);
+    if (v === null)
+        return undefined;
+    const n = Number(v);
+    return Number.isFinite(n) ? n : undefined;
+}
+function countOrUnlimited(h, name) {
+    const v = h.get(name);
+    if (v === null)
+        return undefined;
+    if (v === "unlimited")
+        return "unlimited";
+    const n = Number(v);
+    return Number.isFinite(n) ? n : undefined;
+}
+/** Pull the `X-Upgrade-*` block off a response, or undefined when the API did not send one. */
+function parseUpgrade(h) {
+    const plan = h.get("X-Upgrade-Plan");
+    const url = h.get("X-Upgrade-Url");
+    if (!plan || !url)
+        return undefined;
+    const method = h.get("X-Upgrade-Checkout-Method");
+    const endpoint = h.get("X-Upgrade-Checkout-Endpoint");
+    const body = h.get("X-Upgrade-Checkout-Body");
+    const covers = h.get("X-Upgrade-Covers");
+    return {
+        plan,
+        url,
+        credits: num(h, "X-Upgrade-Credits"),
+        priceAud: num(h, "X-Upgrade-Price-AUD"),
+        covers: covers === "full" || covers === "partial" ? covers : undefined,
+        sizedFor: num(h, "X-Upgrade-Sized-For"),
+        checkout: method && endpoint && body !== null
+            ? { method, endpoint, body, prorated: h.get("X-Upgrade-Prorated") === "true" }
+            : undefined,
+    };
+}
+/**
+ * Pull the credit block off a response. Returns undefined when the response carried no
+ * `X-Credits-*` headers at all — the sandbox endpoints and `/v1/uptime` take no key and bill
+ * nothing, so there is nothing to report.
+ */
+function parseCredits(h) {
+    if (h.get("X-Credits-Remaining") === null && h.get("X-Credits-Used") === null) {
+        return undefined;
+    }
+    const warning = h.get("X-Credits-Warning");
+    return {
+        cost: num(h, "X-Credits-Cost"),
+        used: num(h, "X-Credits-Used"),
+        limit: countOrUnlimited(h, "X-Credits-Limit"),
+        remaining: countOrUnlimited(h, "X-Credits-Remaining"),
+        pctUsed: num(h, "X-Credits-Pct-Used"),
+        warning: warning === "approaching-limit" ? warning : undefined,
+        upgrade: parseUpgrade(h),
+    };
+}
+//# sourceMappingURL=credits.js.map

package/dist/cjs/credits.js.map

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