@volter/twin-linkedin 0.1.0

package/dist/src/linkedin-budget.js

@@ -0,0 +1,87 @@
+// LinkedIn's CLIENT-SIDE RATE BUDGET — this pack's DECLARATION (the numbers) plus the thin typed
+// bindings the perform and refresh adapters use. The MECHANISM — the durable token-keyed ledger, the
+// rolling window, reserve-under-lock, the Retry-After / 429 cooldown, fail-CLOSED on a corrupt ledger
+// — lives ONCE in the kernel (`@volter/world-core` → rateBudget.ts).
+//
+// ── HOW THE CEILING WAS CHOSEN ──────────────────────────────────────────────────────────────
+// LinkedIn's published scheme, live-fetched for this build (learn.microsoft.com/linkedin/shared/
+// api-guide/concepts/rate-limits, fetched 2026-09-26): "Rate limits specify the maximum number of
+// API calls that can be made in a 24 hour period. These limits reset at midnight UTC every day",
+// per application and per member, "Rate limited requests will receive a 429 response", and
+// "Standard rate limits are not published in documentation" — each app reads its own in the
+// Developer Portal. So there is NO first-party figure to transcribe, and the declaration stays at
+// or under the kernel fallback: a one-hour window (the longest the kernel's rolling ledger keeps),
+// 600 weighted units in it, and a burst of 30 units a minute — the fallback's own burst, so no
+// VENDOR_BURST_ANCHOR is needed. A post or a delete (the org speaking in public) costs 5, the
+// upload control calls 2, every read 1, anything unnamed 2.
+//
+// WHAT IS NOT CHARGED. The part uploads a video perform sends to the signed www.linkedin.com
+// /dms-uploads URLs (presigned requests) are not API calls — the rate-limit page limits "API
+// requests", and those URLs are the upload service, carrying their own signature — so the budgeted
+// executor passes them through uncharged. Their number is bounded by construction instead: a
+// perform refuses a video over the feed's 500 MB (at most 125 parts of 4 MB) before initializing.
+import { declareRateBudget, rateBudgetPath, rateBudgetWeight, RateBudget, } from '@volter/world-core';
+const VENDOR = 'linkedin';
+/** Rolling window, in ms — the longest the kernel's ledger keeps (LinkedIn's own window is a day). */
+export const LINKEDIN_BUDGET_WINDOW_MS = 60 * 60_000;
+/** Weighted units allowed inside one window: conservative, not transcribed (no figure is published). */
+export const LINKEDIN_BUDGET_CEILING = 600;
+/** Weighted units in any 60 s: the kernel fallback's 30, so no burst anchor is required. */
+export const LINKEDIN_BUDGET_BURST_CEILING = 30;
+/** Seconds. A Retry-After above this means the member or app is out for the day — fail loudly. */
+export const LINKEDIN_BUDGET_MAX_RETRY_AFTER_S = 3600;
+export const LINKEDIN_CALL_WEIGHTS = {
+    /** A post or its deletion — the organization speaking, in public. */
+    write: 5,
+    /** initializeUpload / finalizeUpload. */
+    upload: 2,
+    /** A read: a video's status, a finder page, an organization, the ACLs. */
+    read: 1,
+    /** Everything else on the vendor: priced above a read. */
+    other: 2,
+};
+/** THE PACK'S DECLARATION — pure data, the only LinkedIn-specific thing in the whole budget. */
+export const LINKEDIN_RATE_BUDGET = {
+    windowMs: LINKEDIN_BUDGET_WINDOW_MS,
+    ceiling: LINKEDIN_BUDGET_CEILING,
+    burstCeiling: LINKEDIN_BUDGET_BURST_CEILING,
+    defaultWeight: LINKEDIN_CALL_WEIGHTS.other,
+    maxRetryAfterSeconds: LINKEDIN_BUDGET_MAX_RETRY_AFTER_S,
+    rules: [
+        { match: '^POST /rest/posts$', weight: LINKEDIN_CALL_WEIGHTS.write },
+        { match: '^DELETE /rest/posts/', weight: LINKEDIN_CALL_WEIGHTS.write },
+        { match: '^POST /rest/(videos|images)$', weight: LINKEDIN_CALL_WEIGHTS.upload },
+        { match: '^GET /rest/', weight: LINKEDIN_CALL_WEIGHTS.read },
+    ],
+    reason: 'LinkedIn limits API calls per application and per member over a 24-hour period reset at midnight UTC, '
+        + 'answers an exceeded limit with 429, and states "Standard rate limits are not published in documentation" '
+        + '(learn.microsoft.com/linkedin/shared/api-guide/concepts/rate-limits, fetched 2026-09-26). With no published '
+        + 'figure, this declaration stays at or under the kernel fallback rather than dressing a guess as a vendor fact: '
+        + '600 weighted units per rolling hour (the longest window the ledger keeps) and a 30-unit burst per minute (the '
+        + "fallback's own). A post or a delete costs 5, an upload initialize/finalize 2, a read 1, anything unnamed 2. The "
+        + 'signed /dms-uploads part PUTs are not API requests and are not charged; a perform bounds them to 125 parts.',
+};
+declareRateBudget(VENDOR, LINKEDIN_RATE_BUDGET);
+/** Price one call, keyed `"<METHOD> <path>"` with the query split off and the method upper-cased. */
+export function linkedinCallWeight(method, path) {
+    const at = path.indexOf('?');
+    const query = {};
+    if (at !== -1)
+        for (const [k, v] of new URLSearchParams(path.slice(at + 1)))
+            query[k] = v;
+    const raw = at === -1 ? path : path.slice(0, at);
+    const bare = raw.length > 1 && raw.endsWith('/') ? raw.replace(/\/+$/, '') : raw;
+    return rateBudgetWeight(VENDOR, `${String(method).toUpperCase()} ${bare}`, query);
+}
+/** Where this vendor's ledger lives: token-keyed and cwd-independent by default. */
+export function linkedinBudgetPath(opts = {}) {
+    const o = typeof opts === 'string' ? { root: opts } : opts;
+    return rateBudgetPath({ ...o, vendor: VENDOR });
+}
+/** This vendor's budget — the kernel guard bound to this declaration. */
+export class LinkedinBudget extends RateBudget {
+    constructor(opts = {}) {
+        super({ ...opts, vendor: VENDOR });
+    }
+}
+export { RateBudgetError as LinkedinBudgetError } from '@volter/world-core';

package/dist/src/linkedin-capabilities.d.ts

@@ -0,0 +1,4 @@
+import { type CapabilityReport, type CapabilitySpec } from '@volter/world-tooling';
+export declare const LINKEDIN_AREAS: readonly ["versioning", "auth", "organizations", "posts", "images", "videos", "documents", "social", "statistics", "errors", "twin_control", "connector", "rate_limit", "mirror"];
+export declare const LINKEDIN_CAPABILITIES: CapabilitySpec[];
+export declare function linkedinCapabilities(): Promise<CapabilityReport>;