@xforge-dev/forge-kit 0.17.1 → 0.18.1

package/dist/client.d.ts

@@ -12,3 +12,4 @@ export { ForgeLogo, type ForgeLogoProps } from './forge-logo.js';
 export { ForgeSupportButton, BUY_ME_A_COFFEE_URL, BUY_ME_A_COFFEE_BUTTON, FORGE_SPONSOR_TIERS, ForgeSupporterBadge, type ForgeSupporterTier, type ForgeSupportButtonProps, } from './support-button.js';
 export { ForgeIgnInput, FORGE_ACCENTED_LETTERS, FORGE_NO_AUTOFILL, type ForgeIgnInputProps, } from './ign-input.js';
 export { ForgeFooter, type ForgeFooterProps } from './forge-footer.js';
+export { ForgeJobsProvider } from './jobs-provider.js';

package/dist/client.js

@@ -13,3 +13,4 @@ export { ForgeLogo } from './forge-logo.js';
 export { ForgeSupportButton, BUY_ME_A_COFFEE_URL, BUY_ME_A_COFFEE_BUTTON, FORGE_SPONSOR_TIERS, ForgeSupporterBadge, } from './support-button.js';
 export { ForgeIgnInput, FORGE_ACCENTED_LETTERS, FORGE_NO_AUTOFILL, } from './ign-input.js';
 export { ForgeFooter } from './forge-footer.js';
+export { ForgeJobsProvider } from './jobs-provider.js';

package/dist/index.d.ts

@@ -7,3 +7,4 @@ export { isForgeAuthConfigured } from './config.js';
 export * from './theme.js';
 export { FORGE_BRANDS, FORGE_CDN, type ForgeBrand, type ForgeBrandId } from './brand.js';
 export { HANDOFF_PATH, LEGACY_ORIGINS, LEGACY_ROOT_DOMAIN, decideLegacy, legacyReceiveHtml, legacySendHtml, type LegacyDecision } from './legacy.js';
+export * from './jobs.js';

package/dist/index.js

@@ -7,3 +7,4 @@ export { isForgeAuthConfigured } from './config.js';
 export * from './theme.js';
 export { FORGE_BRANDS, FORGE_CDN } from './brand.js';
 export { HANDOFF_PATH, LEGACY_ORIGINS, LEGACY_ROOT_DOMAIN, decideLegacy, legacyReceiveHtml, legacySendHtml } from './legacy.js';
+export * from './jobs.js';

package/dist/jobs-provider.d.ts

@@ -0,0 +1,7 @@
+import type { ReactElement, ReactNode } from 'react';
+import { type JobCatalog } from './jobs.js';
+/** Installs the server-fetched catalog before the children render, so client lookups agree with the server. */
+export declare function ForgeJobsProvider({ catalog, children }: {
+    catalog: JobCatalog;
+    children: ReactNode;
+}): ReactElement;

package/dist/jobs-provider.js

@@ -0,0 +1,9 @@
+'use client';
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { getJobCatalog, setJobCatalog } from './jobs.js';
+/** Installs the server-fetched catalog before the children render, so client lookups agree with the server. */
+export function ForgeJobsProvider({ catalog, children }) {
+    if (catalog.updated !== getJobCatalog().updated)
+        setJobCatalog(catalog);
+    return _jsx(_Fragment, { children: children });
+}

package/dist/jobs-server.d.ts

@@ -0,0 +1,12 @@
+import { type JobCatalog } from './jobs.js';
+/**
+ * Fetches the shared job catalog (Next's fetch cache, one hour by default), validates it and installs it
+ * as the registry. The fetch gives up after `timeoutMs` (default 3s). Any failure, timeout included, leaves the
+ * current catalog in place and warns once per distinct error.
+ */
+export declare function refreshJobCatalog(opts?: {
+    url?: string;
+    revalidate?: number;
+    timeoutMs?: number;
+    fetch?: typeof fetch;
+}): Promise<JobCatalog>;

package/dist/jobs-server.js

@@ -0,0 +1,29 @@
+import { getJobCatalog, parseJobCatalog, setJobCatalog, JOB_CATALOG_URL } from './jobs.js';
+const warned = new Set();
+/**
+ * Fetches the shared job catalog (Next's fetch cache, one hour by default), validates it and installs it
+ * as the registry. The fetch gives up after `timeoutMs` (default 3s). Any failure, timeout included, leaves the
+ * current catalog in place and warns once per distinct error.
+ */
+export async function refreshJobCatalog(opts = {}) {
+    const doFetch = opts.fetch ?? fetch;
+    try {
+        const res = await doFetch(opts.url ?? JOB_CATALOG_URL, {
+            next: { revalidate: opts.revalidate ?? 3600 },
+            signal: AbortSignal.timeout(opts.timeoutMs ?? 3000),
+        });
+        if (!res.ok)
+            throw new Error(`job catalog: HTTP ${res.status}`);
+        const next = parseJobCatalog(await res.json());
+        setJobCatalog(next);
+        return next;
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        if (!warned.has(message)) {
+            warned.add(message);
+            console.warn(`[forge-kit] job catalog refresh failed: ${message}`);
+        }
+        return getJobCatalog();
+    }
+}

package/dist/jobs-snapshot.d.ts

@@ -0,0 +1,2 @@
+import type { JobCatalog } from './jobs.js';
+export declare const JOBS_SNAPSHOT: JobCatalog;