@profullstack/agenticjobs 0.11.0 → 0.14.0

package/dist/schema/jsonld.js

@@ -60,15 +60,16 @@ export function jobPostingJsonLd(job, origin) {
     }
     const salary = job.salary;
     if (salary.min !== null || salary.max !== null) {
-        const min = salary.min ?? salary.max;
-        const max = salary.max ?? salary.min;
+        // An absent endpoint is an open bound, not an exact salary. Keep it
+        // absent in both representations instead of copying the other endpoint.
+        const { min, max } = salary;
         doc['baseSalary'] = {
             '@type': 'MonetaryAmount',
             currency: salary.currency.toUpperCase(),
             value: {
                 '@type': 'QuantitativeValue',
-                minValue: min,
-                maxValue: max,
+                ...(min !== null ? { minValue: min } : {}),
+                ...(max !== null ? { maxValue: max } : {}),
                 unitText: salary.period.toUpperCase(),
             },
         };
@@ -77,8 +78,8 @@ export function jobPostingJsonLd(job, origin) {
             currency: salary.currency.toUpperCase(),
             value: {
                 '@type': 'QuantitativeValue',
-                minValue: Math.round((min ?? 0) * (PER_YEAR[salary.period] ?? 1)),
-                maxValue: Math.round((max ?? 0) * (PER_YEAR[salary.period] ?? 1)),
+                ...(min !== null ? { minValue: Math.round(min * (PER_YEAR[salary.period] ?? 1)) } : {}),
+                ...(max !== null ? { maxValue: Math.round(max * (PER_YEAR[salary.period] ?? 1)) } : {}),
                 unitText: 'YEAR',
             },
         };

package/dist/schema/jsonld.js.map

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

package/dist/schema/pay.d.ts

@@ -0,0 +1,173 @@
+/**
+ * What a listing pays, in the words people use to say it.
+ *
+ * A salary range per year was the whole vocabulary, and it described one
+ * kind of work. The listings this board is for pay per task, per pull
+ * request, per social post, a flat fee for a project, a share of revenue, or
+ * a bounty, in dollars or in a coin, settled over whatever rail the two sides
+ * agree on. ugig.net has carried that vocabulary for a year (`budget_type`,
+ * `budget_unit`, `payment_coin`) and this is the same model, so a gig there
+ * and a job here describe pay the same way and a shared package can lift it
+ * later without either side changing shape.
+ *
+ * Three ideas, kept apart on purpose:
+ *
+ *   - A LINE is one price: an amount or range, what it is per, and what it
+ *     is denominated in. A listing may carry several: "$0.25 per task" and
+ *     "$0.25 per PR that fixes a bug" are two lines, not one with a note.
+ *   - The DENOMINATION is what the number is written in: USD, EUR, or a
+ *     ticker such as SOL. "$0.25 per task" is denominated in dollars even
+ *     when it is paid in SOL.
+ *   - The METHOD is the rail it is settled over: SOL, USDC, a bank transfer,
+ *     PayPal, payroll. One per listing, separate from the price, because
+ *     "$100 an hour paid in USDC" is one rate with a preference, not two
+ *     rates - the number does not change because the rail did.
+ *
+ * Everything here is text in, text out. A person types "$0.25 per task", an
+ * agent sends the same string, the front matter of a job file carries it as a
+ * list, and the page prints it back. The structured form is what the API
+ * serves, but the string is what everybody writes, so the parser is the
+ * feature and the JSON is its shadow.
+ *
+ * No imports from the rest of the board: this file is meant to be lifted into
+ * a shared package with ugig.net and CoinPay behind it.
+ */
+/**
+ * The kinds of price. The same list ugig.net's `budget_type` carries, in the
+ * same spelling, so a value round-trips between the two boards untouched.
+ *
+ *   hourly … yearly   a rate per unit of time
+ *   fixed             a flat fee for the whole engagement
+ *   per_task          a price per task, the unit being "task"
+ *   per_unit          a price per anything else, named in `unit`
+ *   revenue_share     a percentage; min and max are percentages
+ *   bounty            a fixed payout for an accepted submission
+ */
+export declare const PAY_TYPES: readonly ["hourly", "daily", "weekly", "monthly", "yearly", "fixed", "per_task", "per_unit", "revenue_share", "bounty"];
+export type PayType = (typeof PAY_TYPES)[number];
+/**
+ * Coins a listing is commonly settled in. ugig.net's list, which is the set
+ * CoinPay can take payment in; Lightning and on-chain BTC are deliberately
+ * not on it because CoinPay cannot settle them. The method field is free
+ * text and accepts anything, so this list only drives the suggestions in a
+ * form and the upper-casing of a ticker somebody typed in lowercase.
+ */
+export declare const PAYMENT_COINS: readonly ["SOL", "ETH", "USDC", "USDT", "POL"];
+/** Rails that are not coins, offered beside them in a form. */
+export declare const PAYMENT_RAILS: readonly ["bank transfer", "PayPal", "payroll", "card", "invoice"];
+export interface PayLine {
+    type: PayType;
+    /** Bottom of the range, or the only figure. Percent for revenue_share. */
+    min: number | null;
+    /** Top of the range. Null for a single figure or an open-ended floor. */
+    max: number | null;
+    /** What the figure is written in: an ISO code or a ticker. `%` for a share. */
+    currency: string;
+    /** For per_task and per_unit: what one of them is. Null otherwise. */
+    unit: string | null;
+}
+export interface Pay {
+    lines: PayLine[];
+    /** How it is settled: a coin such as SOL, or a rail such as "bank transfer". */
+    method: string | null;
+    /** Free text, "0.1% - 0.4%". Never parsed. */
+    equity: string | null;
+    /**
+     * The role pays nothing, and the employer is saying so. Distinct from an
+     * empty `lines`, which means nobody filled the field in.
+     */
+    unpaid: boolean;
+}
+export declare const EMPTY_PAY: Pay;
+/** The most lines a listing can carry. Past this it is a rate card, not a job. */
+export declare const PAY_LINES_MAX = 8;
+/** The longest a per-unit description can be: "PR that fixes a bug you find". */
+export declare const UNIT_MAX = 60;
+export declare const METHOD_MAX = 40;
+export declare const EQUITY_MAX = 60;
+export declare const isFiat: (code: string) => boolean;
+export declare const isKnownCurrency: (code: string) => boolean;
+/** The period word for a time-based line, or null for every other kind. */
+export declare function periodOf(type: PayType): 'hour' | 'day' | 'week' | 'month' | 'year' | null;
+export declare function isPayType(value: unknown): value is PayType;
+/** How a pay line is written, for every error message that has to explain it. */
+export declare const PAY_LINE_EXAMPLES = "\"$0.25 per task\", \"$120k - $150k a year\", \"$100 an hour\", \"$5000 fixed\", \"0.01 SOL per PR that fixes a bug\", \"10% revenue share\"";
+/**
+ * One pay line from the way a person wrote it.
+ *
+ * Returns the line, or a sentence saying what could not be read. A sentence
+ * rather than a throw, because the caller is a form or an API handler and
+ * the person has to be told which line and what it should look like.
+ */
+export declare function parsePayLine(input: unknown): PayLine | string;
+/** The line and, when the text named one, the rail it is settled over. */
+export declare function readPayLine(input: unknown): {
+    line: PayLine;
+    method: string | null;
+} | string;
+/** "$0.25", "$120k", "0.01 SOL", "CAD 1,000", "10%". */
+export declare function formatAmount(amount: number, currency: string): string;
+/**
+ * One line, the way it is printed everywhere: the badge on a card, the CLI,
+ * the TUI, a federated result. A single endpoint is a bound rather than a
+ * fixed figure, and is labelled as one.
+ */
+export declare function formatPayLine(line: PayLine): string;
+/** Every line, or "Unpaid", or null when the listing says nothing about pay. */
+export declare function formatPay(pay: Pay): string | null;
+/** The first line only, for a badge with one line of room. */
+export declare function formatPayShort(pay: Pay): string | null;
+/** "Paid in SOL", "Paid by bank transfer". */
+export declare function formatMethod(method: string | null): string | null;
+/** Has the employer said what it pays? Unpaid counts: it is a statement. */
+export declare function payStated(pay: Pay): boolean;
+export interface SalaryLike {
+    min: number | null;
+    max: number | null;
+    currency: string;
+    period: string;
+    equity?: string | null;
+    unpaid?: boolean;
+}
+/** A listing from a board that predates pay lines, read into the new shape. */
+export declare function payFromSalary(salary: SalaryLike): Pay;
+/**
+ * The time-based line a listing's `salary` columns carry, for search, sort
+ * and structured data - all of which compare on an annual basis and have no
+ * meaning for a price per task. The first time-based line wins; a listing
+ * with none has a null range, so it stays out of every salary filter.
+ */
+export declare function salaryFromPay(pay: Pay): {
+    min: number | null;
+    max: number | null;
+    currency: string;
+    period: 'hour' | 'day' | 'week' | 'month' | 'year';
+};
+/** A ticker typed in any case comes out in capitals; a rail stays as typed. */
+export declare function normaliseMethod(value: unknown): string | null;
+/**
+ * Pay, from whatever a form, an API client or a model sent.
+ *
+ * `pay` may be a string (one line, or several separated by newlines), an
+ * array of strings or of line objects, or an object with `lines` and
+ * `method`. The old flat fields - salaryMin, salaryMax, salaryCurrency,
+ * salaryPeriod, salaryUnpaid, salaryEquity - still work and become one line,
+ * so a client written against 0.11 keeps posting listings.
+ *
+ * Returns the pay, or a sentence saying which line could not be read.
+ */
+export declare function normalisePay(input: Record<string, unknown>): Pay | string;
+/**
+ * The pay of any listing, including one from a board that predates `pay`.
+ *
+ * Federated search puts listings from other instances on this board's pages,
+ * and an instance still on 0.11 serves a `salary` and no `pay`. Reading
+ * `job.pay` straight would throw on those, so every display path goes
+ * through here.
+ */
+export declare function payOfJob(job: {
+    pay?: Pay | null;
+    salary?: SalaryLike | null;
+}): Pay;
+/** The lines as the text a person would type, one per line. Round-trips through parsePayLine. */
+export declare function payToText(pay: Pay): string;