mcp-scraper 0.44.3 → 0.45.0

package/dist/{server-JJLFY46K.js → server-7B75SDNG.js}

@@ -56,6 +56,7 @@ import {
   HttpMcpToolExecutor,
   InternalScheduledArtifactRenderRequestSchema,
   ListScheduledRunsQuerySchema,
+  LocalSourcebookSchemaTypeSchema,
   PublicScheduledRunTokenSchema,
   RenewEditorialReadingRoomDownloadInputSchema,
   SCHEDULED_ARTIFACT_TEMPLATE_PRESET,
@@ -72,11 +73,13 @@ import {
   configureReportSaving,
   createConnectedDataArtifact,
   createDirectoryCsvArtifact,
+  defaultLocalSourcebookSchemaType,
   exportFanout,
   handleMcpTasksHttpRequest,
   harvestTimeoutBudget,
   hashOwnerId,
   isLoopbackBaseUrl,
+  localSourcebookSchemaContract,
   outputBaseDir,
   registerBrowserAgentMcpTools,
   registerMemoryMcpTools,
@@ -85,8 +88,9 @@ import {
   renewConnectedDataArtifactDownload,
   renewDirectoryArtifactDownload,
   resolveDeploymentProfile,
+  resolveLocalSourcebookSchemaType,
   transcribeMediaUrl
-} from "./chunk-2SE4GYCS.js";
+} from "./chunk-FQIICRR4.js";
 import {
   auditImageUrls,
   auditImages,
@@ -142,7 +146,7 @@ import {
 } from "./chunk-3ZUBQQPQ.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-32Z52OE4.js";
+} from "./chunk-CEZ3NFBP.js";
 import {
   abandonExtractSettlement,
   countSuccessfulPages,
@@ -165,7 +169,7 @@ import {
   setExtractJobTotal,
   settleExtractJob,
   terminalExtractJobStatus
-} from "./chunk-WWIJ2NID.js";
+} from "./chunk-JFOT5JEL.js";
 import {
   BROWSER_OPEN_MIN_BALANCE_MC,
   CONCURRENCY_PRICE_ID,
@@ -178,6 +182,7 @@ import {
   CONNECTED_USAGE_RATE_POLICY,
   CONNECTED_USAGE_RATE_POLICY_VERSION,
   CREDIT_COST_CATALOG,
+  LISTING_WRITE_RATE_POLICY,
   LedgerOperation,
   MC_COSTS,
   MC_PER_CREDIT,
@@ -213,7 +218,7 @@ import {
   tierChangeLeavesPrivateOffer,
   tierCreditsPerInterval,
   vendorCostUsdToMc
-} from "./chunk-X5WDJ7D7.js";
+} from "./chunk-SOEYDWJU.js";
 import {
   CaptchaError,
   MapsSearchIncompletePageError,
@@ -8667,7 +8672,7 @@ var siteExtractFn = inngest.createFunction(
       });
     }) : null;
     const finalized = await step.run("finalize", async () => {
-      const { assembleExtractArtifacts } = await import("./extract-bundle-U3MNYDKC.js");
+      const { assembleExtractArtifacts } = await import("./extract-bundle-DYMQRQWG.js");
       const current = await getExtractJob(jobId2);
       if (!current) throw new Error("extract job disappeared before finalization");
       const stored = await assembleExtractArtifacts(current, { branding, imageAudit });
@@ -12033,16 +12038,18 @@ async function createLocalSourcebookSubmission(input) {
     const existing = await db.execute({ sql: `SELECT * FROM local_sourcebook_submissions WHERE owner_user_id = ? AND idempotency_key = ? LIMIT 1`, args: [input.ownerUserId, input.idempotencyKey] });
     if (existing.rows[0]) {
       const submission = mapSubmission(existing.rows[0]);
-      if (submission.category !== input.category || submission.state !== input.state || submission.slug !== input.slug || submission.businessName !== input.businessName || submission.websiteUrl !== input.websiteUrl) throw new Error("Local Sourcebook idempotency key conflicts with a different listing identity.");
+      if (submission.category !== input.category || submission.state !== input.state || submission.slug !== input.slug || submission.businessName !== input.businessName || submission.websiteUrl !== input.websiteUrl || input.schemaOrgType != null && submission.coverage.schemaOrgType !== input.schemaOrgType) throw new Error("Local Sourcebook idempotency key conflicts with a different listing identity.");
       return submission;
     }
   }
   const id = `lsb_${randomUUID3().replace(/-/g, "")}`;
   const coverage = {
-    requested: ["website_crawl", "services_products", "service_areas", "genuine_images", "staff_team", "review_sources"],
+    requested: ["website_crawl", "structured_data", "services_products", "service_areas", "genuine_images", "staff_team", "review_sources"],
     crawl: { state: "queued", pagesDiscovered: 0, pagesCaptured: 0 },
     media: { state: "queued", genuineImagesCaptured: 0 },
-    reviews: { state: "queued", captured: 0, availableReported: null, stopReason: null }
+    reviews: { state: "queued", captured: 0, availableReported: null, stopReason: null },
+    ...input.schemaOrgType ? { schemaOrgType: input.schemaOrgType } : {},
+    ...input.billing ? { billing: { mode: "fixed_listing_write", ...input.billing } } : {}
   };
   await db.batch([
     { sql: `INSERT INTO local_sourcebook_submissions (id, owner_user_id, category, state, slug, business_name, website_url, coverage_json, idempotency_key) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, args: [id, input.ownerUserId, input.category, input.state, input.slug, input.businessName, input.websiteUrl, JSON.stringify(coverage), input.idempotencyKey ?? null] },
@@ -12062,13 +12069,17 @@ async function getLocalSourcebookDraft(id, ownerUserId) {
   const result = await getDb().execute({ sql: `SELECT payload_json FROM local_sourcebook_revisions WHERE submission_id = ? AND revision = ?`, args: [id, submission.draftRevision] });
   return result.rows[0] ? parseJson2(result.rows[0].payload_json) : null;
 }
-async function queueLocalSourcebookRefresh(id, ownerUserId) {
+async function queueLocalSourcebookRefresh(id, ownerUserId, billing) {
   const existing = await getLocalSourcebookSubmission(id, ownerUserId);
   if (!existing) return null;
   if (existing.status === "rejected" || existing.status === "unpublished") {
     throw new Error(`A ${existing.status} Local Sourcebook listing cannot be refreshed by its owner.`);
   }
-  const coverage = { ...existing.coverage, refreshRequestedAt: (/* @__PURE__ */ new Date()).toISOString() };
+  const coverage = {
+    ...existing.coverage,
+    refreshRequestedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    ...billing ? { billing: { mode: "fixed_listing_write", ...billing } } : {}
+  };
   await getDb().execute({ sql: `UPDATE local_sourcebook_submissions SET status = 'queued', coverage_json = ?, acquisition_claimed_at = NULL, acquisition_error = NULL, updated_at = datetime('now') WHERE id = ? AND owner_user_id = ?`, args: [JSON.stringify(coverage), id, ownerUserId] });
   await event(id, "enrichment.queued", "owner", String(ownerUserId));
   return getLocalSourcebookSubmission(id, ownerUserId);
@@ -12774,17 +12785,100 @@ var MapsExtractor = class {
   }
 };
 
+// src/api/listing-write-billing.ts
+function operationFor(surface, kind) {
+  if (surface === "local_sourcebook") {
+    return kind === "create" ? LedgerOperation.LOCAL_SOURCEBOOK_CREATE : LedgerOperation.LOCAL_SOURCEBOOK_EDIT;
+  }
+  return kind === "create" ? LedgerOperation.COMMONS_CREATE : LedgerOperation.COMMONS_EDIT;
+}
+function refundOperationFor(surface, kind) {
+  if (surface === "local_sourcebook") {
+    return kind === "create" ? LedgerOperation.LOCAL_SOURCEBOOK_CREATE_REFUND : LedgerOperation.LOCAL_SOURCEBOOK_EDIT_REFUND;
+  }
+  return kind === "create" ? LedgerOperation.COMMONS_CREATE_REFUND : LedgerOperation.COMMONS_EDIT_REFUND;
+}
+function listingWritePrice(kind) {
+  return LISTING_WRITE_RATE_POLICY[kind];
+}
+function listingWriteDebitKey(surface, userId, idempotencyKey3) {
+  return `listing-write:${surface}:${userId}:${idempotencyKey3}`;
+}
+function publicListingWriteBilling(receipt) {
+  return {
+    surface: receipt.surface,
+    operation: receipt.kind,
+    credits: receipt.credits,
+    charged: !receipt.duplicate,
+    idempotentReplay: receipt.duplicate,
+    balanceCredits: receipt.balanceMc / MC_PER_CREDIT,
+    acquisitionIncluded: receipt.surface === "local_sourcebook"
+  };
+}
+async function chargeListingWrite(input) {
+  const price = listingWritePrice(input.kind);
+  const debitKey2 = listingWriteDebitKey(input.surface, input.userId, input.idempotencyKey);
+  const debit = await debitMcIdempotent(
+    input.userId,
+    price.mc,
+    operationFor(input.surface, input.kind),
+    `${input.surface}:${input.kind}`,
+    debitKey2
+  );
+  if (!debit.ok) return { insufficient: insufficientBalanceResponse(debit.balance_mc, price.mc) };
+  return {
+    surface: input.surface,
+    kind: input.kind,
+    userId: input.userId,
+    credits: price.credits,
+    amountMc: price.mc,
+    debitKey: debitKey2,
+    duplicate: debit.duplicate,
+    balanceMc: debit.balance_mc
+  };
+}
+async function refundListingWrite(receipt, reason) {
+  if (receipt.duplicate) return null;
+  return settleDebitMcIdempotent(
+    receipt.userId,
+    receipt.debitKey,
+    0,
+    refundOperationFor(receipt.surface, receipt.kind),
+    reason,
+    receipt.surface
+  );
+}
+async function refundPersistedListingWrite(input) {
+  return settleDebitMcIdempotent(
+    input.userId,
+    input.debitKey,
+    0,
+    refundOperationFor(input.surface, input.kind),
+    input.reason,
+    input.surface
+  );
+}
+
 // src/api/local-sourcebook-compiler.ts
 import { createHash as createHash3 } from "crypto";
 
 // src/api/local-sourcebook-public-urls.ts
 var DEFAULT_ROOT_DOMAIN = "localsourcebook.com";
+var CATEGORY_PUBLIC_SLUGS = {
+  home: "home-services",
+  professional: "professional",
+  restaurants: "restaurants",
+  financial: "financial",
+  realestate: "realestate",
+  auto: "auto",
+  wellness: "wellness"
+};
 function rootDomain() {
   const configured = process.env.LOCAL_SOURCEBOOK_PUBLIC_ROOT_DOMAIN?.trim() || DEFAULT_ROOT_DOMAIN;
   return configured.replace(/^https?:\/\//i, "").replace(/^www\./i, "").replace(/\/.*$/, "").replace(/\.+$/, "").toLowerCase();
 }
 function localSourcebookPublicUrls(category, state, slug2) {
-  const categoryUrl = `https://${category}.${rootDomain()}`;
+  const categoryUrl = `https://${CATEGORY_PUBLIC_SLUGS[category]}.${rootDomain()}`;
   const statePath = `/${state.toLowerCase()}`;
   const profilePath = `${statePath}/${slug2}/`;
   const reviewsPath = `${statePath}/${slug2}/reviews`;
@@ -13091,6 +13185,65 @@ function reviewStopReason(input, captured, exposed) {
   if (exposed && captured < exposed) return `Google Maps stopped exposing additional complete review cards after ${captured} of ${exposed} reported reviews.`;
   return `All ${captured} complete, unique review cards exposed during this acquisition were retained.`;
 }
+function buildLocalBusinessJsonLd(input) {
+  const businessId = `${input.profileUrl}#business`;
+  const business = {
+    "@type": input.schemaOrgType === "LocalBusiness" ? "LocalBusiness" : ["LocalBusiness", input.schemaOrgType],
+    "@id": businessId,
+    url: input.profileUrl,
+    name: input.name,
+    description: input.description,
+    ...input.phone ? { telephone: input.phone } : {},
+    ...input.address || input.locality || input.region || input.postalCode ? {
+      address: {
+        "@type": "PostalAddress",
+        ...input.address ? { streetAddress: input.address } : {},
+        ...input.locality ? { addressLocality: input.locality } : {},
+        ...input.region ? { addressRegion: input.region } : {},
+        ...input.postalCode ? { postalCode: input.postalCode } : {},
+        addressCountry: "US"
+      }
+    } : {},
+    ...Number.isFinite(input.latitude) && Number.isFinite(input.longitude) ? {
+      geo: { "@type": "GeoCoordinates", latitude: input.latitude, longitude: input.longitude }
+    } : {},
+    ...input.images.length ? { image: input.images } : {},
+    ...input.serviceAreas.length ? { areaServed: input.serviceAreas } : {},
+    ...input.services.length ? {
+      hasOfferCatalog: {
+        "@type": "OfferCatalog",
+        name: "Services",
+        itemListElement: input.services.map((name) => ({ "@type": "Offer", itemOffered: { "@type": "Service", name } }))
+      }
+    } : {},
+    ...Number.isFinite(input.rating) && Number.isFinite(input.ratingCount) && Number(input.ratingCount) > 0 ? {
+      aggregateRating: { "@type": "AggregateRating", ratingValue: input.rating, reviewCount: input.ratingCount, bestRating: 5, worstRating: 1 }
+    } : {},
+    sameAs: unique([input.website, input.mapsUrl], 10)
+  };
+  const graph = [business, {
+    "@type": "BreadcrumbList",
+    "@id": `${input.profileUrl}#breadcrumbs`,
+    itemListElement: [
+      { "@type": "ListItem", position: 1, name: "Local Sourcebook", item: "https://localsourcebook.com/" },
+      { "@type": "ListItem", position: 2, name: input.region || "State directory", item: input.stateUrl },
+      { "@type": "ListItem", position: 3, name: input.name, item: input.profileUrl }
+    ]
+  }];
+  if (input.faq.length) {
+    graph.push({
+      "@type": "FAQPage",
+      "@id": `${input.profileUrl}#faq`,
+      about: { "@id": businessId },
+      mainEntity: input.faq.map((item) => ({
+        "@type": "Question",
+        name: item.question,
+        acceptedAnswer: { "@type": "Answer", text: item.answer }
+      }))
+    });
+  }
+  return { "@context": "https://schema.org", "@graph": graph };
+}
 function compileLocalSourcebookListing(input) {
   const collectedAt = input.collectedAt ?? (/* @__PURE__ */ new Date()).toISOString();
   const pages = successfulPages(input.site);
@@ -13160,6 +13313,33 @@ function compileLocalSourcebookListing(input) {
     }
   ];
   const publicUrls = localSourcebookPublicUrls(input.submission.category, input.submission.state, input.submission.slug);
+  const schemaOrgType = resolveLocalSourcebookSchemaType(input.submission.category, input.submission.coverage.schemaOrgType);
+  const listingName = maps?.name || input.submission.businessName;
+  const listingWebsite = maps?.website || input.submission.websiteUrl;
+  const listingMapsUrl = maps?.placeUrl || maps?.cidUrl || void 0;
+  const stateUrl = new URL(`/${input.submission.state.toLowerCase()}`, publicUrls.profileUrl).href;
+  const jsonLd = buildLocalBusinessJsonLd({
+    schemaOrgType,
+    profileUrl: publicUrls.profileUrl,
+    stateUrl,
+    name: listingName,
+    description: summary,
+    address: location2.address,
+    locality: location2.locality,
+    region: location2.region,
+    postalCode: location2.postalCode,
+    phone: maps?.phoneDisplay || maps?.phone || void 0,
+    website: listingWebsite,
+    mapsUrl: listingMapsUrl,
+    latitude: maps?.lat ?? void 0,
+    longitude: maps?.lng ?? void 0,
+    services,
+    serviceAreas,
+    images: media.map((item) => String(item.src)),
+    rating: Number.isFinite(rating) ? rating : void 0,
+    ratingCount: Number.isFinite(exposedCount) ? exposedCount : void 0,
+    faq
+  });
   const listing = {
     id: input.submission.id,
     publicationRevision: input.submission.draftRevision + 1,
@@ -13176,7 +13356,9 @@ function compileLocalSourcebookListing(input) {
       profile: publicUrls.profileUrl,
       reviews: publicUrls.reviewsUrl
     },
-    name: maps?.name || input.submission.businessName,
+    name: listingName,
+    schemaOrgType,
+    jsonLd,
     summary,
     description,
     address: location2.address,
@@ -13184,8 +13366,8 @@ function compileLocalSourcebookListing(input) {
     region: location2.region,
     postalCode: location2.postalCode,
     phone: maps?.phoneDisplay || maps?.phone || void 0,
-    website: maps?.website || input.submission.websiteUrl,
-    mapsUrl: maps?.placeUrl || maps?.cidUrl || void 0,
+    website: listingWebsite,
+    mapsUrl: listingMapsUrl,
     latitude: maps?.lat ?? void 0,
     longitude: maps?.lng ?? void 0,
     hours,
@@ -13225,11 +13407,12 @@ function compileLocalSourcebookListing(input) {
   return {
     listing,
     coverage: {
-      requested: ["website_crawl", "services_products", "service_areas", "genuine_images", "staff_team", "review_sources"],
+      requested: ["website_crawl", "structured_data", "services_products", "service_areas", "genuine_images", "staff_team", "review_sources"],
       crawl: { state: input.siteError ? "failed" : input.site?.truncated ? "partial" : "complete", pagesDiscovered: input.site?.spider.totalFound ?? 0, pagesCaptured: pages.length, requestedMaximum: input.requestedMaxPages, error: input.siteError ?? null },
       media: { state: input.siteError ? "failed" : "complete", genuineImagesCaptured: media.length, teamImagesCaptured: media.filter((item) => item.kind === "team").length },
       reviews: { state: input.mapsError || input.reviewBillingLimited ? "partial" : "complete", captured: reviews.length, availableReported: Number.isFinite(exposedCount) ? exposedCount : null, requestedMaximum: input.requestedMaxReviews, stopReason: reviewStopReason(input, reviews.length, Number.isFinite(exposedCount) ? exposedCount : void 0) },
       maps: { state: maps ? "complete" : "failed", exactPlaceUrl: maps?.placeUrl ?? null, cid: maps?.cidDecimal ?? maps?.cid ?? null, error: input.mapsError ?? null },
+      structuredData: { state: "complete", rootType: "LocalBusiness", schemaOrgType, graphNodes: jsonLd["@graph"].length },
       compiledAt: collectedAt
     }
   };
@@ -13314,110 +13497,83 @@ async function runLocalSourcebookAcquisition(submission, provider = createDefaul
   const user = await getUserById(submission.ownerUserId);
   if (!user) throw new Error("The submission owner is no longer active.");
   if (!user.subscription_tier) throw new Error("An active MCP Scraper subscription is required for acquisition.");
-  const billingCycle = `local-sourcebook:${submission.id}:revision:${submission.draftRevision}`;
-  const mapsDescription = `Local Sourcebook: ${submission.businessName}`;
-  const mapsHold = await debitMcIdempotent(
-    submission.ownerUserId,
-    MC_COSTS.maps_place,
-    LedgerOperation.MAPS_PLACE,
-    mapsDescription,
-    `${billingCycle}:maps-place`
-  );
-  if (!mapsHold.ok) throw new Error(`Insufficient credits: Local Sourcebook needs at least ${MC_COSTS.maps_place / 100} credits for exact-place acquisition before website pages and reviews.`);
-  const balanceAfterMapsHold = mapsHold.balance_mc;
-  const maxPages = Math.min(LOCAL_SOURCEBOOK_MAX_PAGES, Math.floor(balanceAfterMapsHold / MC_COSTS.page_scrape));
+  const storedBilling = submission.coverage.billing;
+  const inferredKind = submission.publishedRevision == null ? "create" : "edit";
+  const kind = storedBilling?.kind === "edit" ? "edit" : storedBilling?.kind === "create" ? "create" : inferredKind;
+  const price = listingWritePrice(kind);
+  let debitKey2 = typeof storedBilling?.debitKey === "string" ? storedBilling.debitKey : "";
+  if (!debitKey2) {
+    const fallback = await chargeListingWrite({
+      surface: "local_sourcebook",
+      kind,
+      userId: submission.ownerUserId,
+      idempotencyKey: `worker:${submission.id}:revision:${submission.draftRevision}`
+    });
+    if ("insufficient" in fallback) throw new Error(fallback.insufficient.message);
+    debitKey2 = fallback.debitKey;
+  }
+  const maxPages = LOCAL_SOURCEBOOK_MAX_PAGES;
   let site = null;
   let maps = null;
   let siteError = null;
   let mapsError = null;
-  let reviewBillingLimited = false;
-  let siteHoldMc = 0;
-  let siteActualMc = 0;
-  let mapsRefunded = false;
-  let reviewsBilledMc = 0;
-  if (maxPages < 1) {
-    siteError = "The subscriber balance covered exact-place acquisition but not a website page.";
-  } else {
-    siteHoldMc = maxPages * MC_COSTS.page_scrape;
-    const siteDescription = `Local Sourcebook: ${new URL(submission.websiteUrl).hostname}`;
-    const siteHold = await debitMcIdempotent(
-      submission.ownerUserId,
-      siteHoldMc,
-      LedgerOperation.EXTRACT_SITE_HOLD,
-      siteDescription,
-      `${billingCycle}:website-hold`
-    );
-    if (!siteHold.ok) {
-      siteError = "The subscriber balance changed before the website acquisition hold could be placed.";
-      siteHoldMc = 0;
-    } else {
-      try {
-        site = await provider.extractWebsite(submission, maxPages);
-        const successfulPages2 = site.pages.filter(isPageExtractionSuccessful).length;
-        siteActualMc = successfulPages2 * MC_COSTS.page_scrape;
-        const refund = siteHoldMc - siteActualMc;
-        if (refund > 0) await creditMcIdempotent(submission.ownerUserId, refund, LedgerOperation.EXTRACT_SITE_REFUND, `Local Sourcebook unused website-page hold: ${submission.id}`, `${billingCycle}:website-unused-refund`);
-        await logRequestEvent({ userId: submission.ownerUserId, source: "local_sourcebook_website", status: "done", query: submission.websiteUrl, resultCount: successfulPages2, result: { submissionId: submission.id, discovered: site.spider.totalFound, captured: successfulPages2, truncated: site.truncated } });
-      } catch (error) {
-        siteError = errorMessage2(error);
-        await creditMcIdempotent(submission.ownerUserId, siteHoldMc, LedgerOperation.EXTRACT_SITE_REFUND, `Local Sourcebook failed website acquisition: ${submission.id}`, `${billingCycle}:website-failure-refund`);
-        siteHoldMc = 0;
-        await logRequestEvent({ userId: submission.ownerUserId, source: "local_sourcebook_website", status: "failed", query: submission.websiteUrl, error: siteError });
-      }
-    }
-  }
   try {
-    maps = await provider.extractMaps(submission, LOCAL_SOURCEBOOK_MAX_REVIEWS);
-    validateLocalSourcebookMapsIdentity(submission, maps);
-    const completeReviewCount = maps.reviews.filter((review) => Boolean(review.text?.trim())).length;
-    if (completeReviewCount > 0) {
-      const reviewCost = completeReviewCount * MC_COSTS.maps_review;
-      const debit = await debitMcIdempotent(
-        submission.ownerUserId,
-        reviewCost,
-        LedgerOperation.MAPS_REVIEW,
-        `Local Sourcebook reviews: ${submission.businessName}`,
-        `${billingCycle}:maps-reviews`
-      );
-      if (debit.ok) {
-        reviewsBilledMc = reviewCost;
-      } else {
-        reviewBillingLimited = true;
-        maps.reviews = [];
-      }
+    try {
+      site = await provider.extractWebsite(submission, maxPages);
+      const successfulPages2 = site.pages.filter(isPageExtractionSuccessful).length;
+      await logRequestEvent({ userId: submission.ownerUserId, source: "local_sourcebook_website", status: "done", query: submission.websiteUrl, resultCount: successfulPages2, result: { submissionId: submission.id, discovered: site.spider.totalFound, captured: successfulPages2, truncated: site.truncated } });
+    } catch (error) {
+      siteError = errorMessage2(error);
+      await logRequestEvent({ userId: submission.ownerUserId, source: "local_sourcebook_website", status: "failed", query: submission.websiteUrl, error: siteError });
     }
-    await logRequestEvent({ userId: submission.ownerUserId, source: "local_sourcebook_maps", status: "done", query: submission.businessName, location: submission.state.toUpperCase(), resultCount: maps.reviews.length, result: { submissionId: submission.id, placeUrl: maps.placeUrl, cid: maps.cidDecimal ?? maps.cid, reviewsStatus: maps.reviewsStatus, reviewsRetained: maps.reviews.length, services: maps.services.length, areasServed: maps.areasServed.length } });
+    try {
+      maps = await provider.extractMaps(submission, LOCAL_SOURCEBOOK_MAX_REVIEWS);
+      validateLocalSourcebookMapsIdentity(submission, maps);
+      await logRequestEvent({ userId: submission.ownerUserId, source: "local_sourcebook_maps", status: "done", query: submission.businessName, location: submission.state.toUpperCase(), resultCount: maps.reviews.length, result: { submissionId: submission.id, placeUrl: maps.placeUrl, cid: maps.cidDecimal ?? maps.cid, reviewsStatus: maps.reviewsStatus, reviewsRetained: maps.reviews.length, services: maps.services.length, areasServed: maps.areasServed.length } });
+    } catch (error) {
+      mapsError = errorMessage2(error);
+      maps = null;
+      await logRequestEvent({ userId: submission.ownerUserId, source: "local_sourcebook_maps", status: "failed", query: submission.businessName, location: submission.state.toUpperCase(), error: mapsError });
+    }
+    if (!maps) throw new Error(`Exact-place acquisition is required before publication. Maps: ${mapsError || "not available"}. Website: ${siteError || (site ? "captured" : "not available")}.`);
+    const compiled = compileLocalSourcebookListing({
+      submission,
+      site,
+      maps,
+      requestedMaxPages: maxPages,
+      requestedMaxReviews: LOCAL_SOURCEBOOK_MAX_REVIEWS,
+      siteError,
+      mapsError,
+      reviewBillingLimited: false
+    });
+    const coverage = {
+      ...compiled.coverage,
+      billing: {
+        mode: "fixed_listing_write",
+        kind,
+        credits: price.credits,
+        amountMc: price.mc,
+        debitKey: debitKey2,
+        acquisitionIncluded: true
+      }
+    };
+    const completed = await completeLocalSourcebookAcquisition(submission.id, compiled.listing, coverage, submission.draftRevision);
+    if (!completed) throw new Error("The Local Sourcebook draft could not be saved after acquisition.");
+    return completed;
   } catch (error) {
-    mapsError = errorMessage2(error);
-    maps = null;
-    await creditMcIdempotent(submission.ownerUserId, MC_COSTS.maps_place, LedgerOperation.REFUND, `Local Sourcebook failed exact-place acquisition: ${submission.id}`, `${billingCycle}:maps-failure-refund`);
-    mapsRefunded = true;
-    await logRequestEvent({ userId: submission.ownerUserId, source: "local_sourcebook_maps", status: "failed", query: submission.businessName, location: submission.state.toUpperCase(), error: mapsError });
-  }
-  if (!maps) throw new Error(`Exact-place acquisition is required before publication. Maps: ${mapsError || "not available"}. Website: ${siteError || (site ? "captured" : "not available")}.`);
-  const compiled = compileLocalSourcebookListing({
-    submission,
-    site,
-    maps,
-    requestedMaxPages: maxPages,
-    requestedMaxReviews: LOCAL_SOURCEBOOK_MAX_REVIEWS,
-    siteError,
-    mapsError,
-    reviewBillingLimited
-  });
-  const coverage = {
-    ...compiled.coverage,
-    billing: {
-      websiteHeldMc: siteHoldMc,
-      websiteUsedMc: siteActualMc,
-      mapsUsedMc: mapsRefunded ? 0 : MC_COSTS.maps_place,
-      reviewsUsedMc: reviewsBilledMc,
-      reviewBillingLimited
+    const current = await getLocalSourcebookSubmission(submission.id).catch(() => null);
+    const revisionAlreadyPublished = current?.status === "published" && current.publishedRevision != null && current.draftRevision > submission.draftRevision;
+    if (!revisionAlreadyPublished) {
+      await refundPersistedListingWrite({
+        surface: "local_sourcebook",
+        kind,
+        userId: submission.ownerUserId,
+        debitKey: debitKey2,
+        reason: `Local Sourcebook acquisition failed: ${errorMessage2(error)}`
+      }).catch(() => null);
     }
-  };
-  const completed = await completeLocalSourcebookAcquisition(submission.id, compiled.listing, coverage, submission.draftRevision);
-  if (!completed) throw new Error("The Local Sourcebook draft could not be saved after acquisition.");
-  return completed;
+    throw error;
+  }
 }
 async function processLocalSourcebookSubmission(submissionId) {
   const submission = await claimLocalSourcebookAcquisition(submissionId);
@@ -21313,6 +21469,7 @@ var DirectoryIdentitySchema = z25.object({
   state: z25.string().trim().length(2).transform((value) => value.toLowerCase()),
   businessName: z25.string().trim().min(2).max(160),
   websiteUrl: z25.url().refine((value) => /^https?:\/\//.test(value), "websiteUrl must use http or https"),
+  schemaOrgType: LocalSourcebookSchemaTypeSchema.optional(),
   slug: z25.string().trim().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/).max(100).optional(),
   tags: z25.array(z25.string().trim().min(1).max(60)).max(20).default([]),
   idempotencyKey: z25.string().trim().min(8).max(200)
@@ -21397,7 +21554,7 @@ async function resolveLocalSourcebookTags(candidates) {
 function getLocalSourcebookContract(category) {
   return {
     name: "Local Sourcebook listing",
-    version: "local_sourcebook_listing_v2",
+    version: "local_sourcebook_listing_v3",
     purpose: "An owner-scoped, evidence-backed local business record with a separate public profile and complete captured-review archive.",
     categories: LOCAL_SOURCEBOOK_CATEGORIES,
     selectedCategory: category ?? null,
@@ -21408,11 +21565,14 @@ function getLocalSourcebookContract(category) {
       reviews: "https://{category}.localsourcebook.com/{state}/{business-slug}/reviews"
     },
     requiredCreateFields: ["category", "state", "businessName", "websiteUrl", "tags", "idempotencyKey"],
-    systemCompiledSections: ["identity", "services/products", "service areas/locations", "genuine media", "reviews and theme counts", "evidence", "answered FAQ", "collection receipts"],
+    optionalCreateFields: ["schemaOrgType"],
+    systemCompiledSections: ["identity", "LocalBusiness JSON-LD", "services/products", "service areas/locations", "genuine media", "reviews and theme counts", "evidence", "answered FAQ", "collection receipts"],
     workflow: ["list-local-sourcebook-tags", "get-local-sourcebook-contract", "prepare-local-sourcebook-write", "validate-local-sourcebook-write", "local-sourcebook-capture", "local_sourcebook_submission_status"],
     ownership: "Only the MCP Scraper account that captures a listing can read it or request a paid evidence refresh.",
+    billing: { validationCredits: 0, createCredits: 10, editCredits: 2, acquisitionIncluded: true, chargeEvent: "accepted_write" },
     acquisition: { websitePagesMaximum: 100, reviewsMaximum: 500, exactMapsIdentityRequired: true, partialResultsRequireStoppingReasons: true },
     publication: { automatic: true, evidenceCompiledOnly: true, ownerAuthoredClaimsAccepted: false, adminReviewRequired: false, lastPublishedRevisionRemainsPublicDuringRefresh: true },
+    structuredData: localSourcebookSchemaContract(category),
     tagPolicy: { inspectVocabularyFirst: true, minimum: 1, maximum: 20, newTagsRequire: ["central=true", "reusable=true", "description"], newTagsStartAs: "pending" }
   };
 }
@@ -21427,17 +21587,20 @@ async function prepareLocalSourcebookWrite(input) {
   ];
   const tagResolutions = await resolveLocalSourcebookTags(candidates);
   const publicUrls = localSourcebookPublicUrls(parsed.category, parsed.state, slug2);
+  const schemaOrgType = parsed.schemaOrgType ?? defaultLocalSourcebookSchemaType(parsed.category);
   return {
     ok: true,
     route: { category: parsed.category, state: parsed.state, slug: slug2, ...publicUrls },
-    proposedWrite: { ...parsed, slug: slug2, tags: tagResolutions.filter((item) => item.action === "reuse").map((item) => item.tag) },
+    proposedWrite: { ...parsed, schemaOrgType, slug: slug2, tags: tagResolutions.filter((item) => item.action === "reuse").map((item) => item.tag) },
     contract: getLocalSourcebookContract(parsed.category),
     tagResolutions,
     instructions: [
       "Resolve every review candidate before capture; do not silently create a near-duplicate tag.",
       "Call validate-local-sourcebook-write with the proposed identity, resolved tags, and any required tag decisions.",
+      "Keep the proposed schemaOrgType or choose a more specific accepted LocalBusiness subtype from the contract. Arbitrary JSON-LD is not accepted.",
       "Call local-sourcebook-capture only after validation returns valid=true. Capture queues paid acquisition and automatically publishes the resulting system-compiled evidence revision.",
-      "Owners cannot supply public listing claims directly. Request local_sourcebook_refresh when source-backed public facts need to be reacquired."
+      "Creating the listing costs 10 Credits total, including acquisition. Validation is free.",
+      "Owners cannot supply public listing claims directly. A source-backed local_sourcebook_refresh costs 2 Credits."
     ]
   };
 }
@@ -21447,7 +21610,10 @@ async function validateLocalSourcebookWrite(input) {
   let normalizedIdentity2;
   const parsedIdentity = DirectoryIdentitySchema.safeParse(input.identity);
   if (!parsedIdentity.success) errors.push(...parsedIdentity.error.issues.map((issue) => `identity.${issue.path.join(".")}: ${issue.message}`));
-  else normalizedIdentity2 = parsedIdentity.data;
+  else normalizedIdentity2 = {
+    ...parsedIdentity.data,
+    schemaOrgType: parsedIdentity.data.schemaOrgType ?? defaultLocalSourcebookSchemaType(parsedIdentity.data.category)
+  };
   const candidates = input.tagCandidates ?? (normalizedIdentity2?.tags.map((tag) => ({ tag })) ?? []);
   const resolutions = await resolveLocalSourcebookTags(candidates);
   const decisions = new Map((input.tagDecisions ?? []).map((decision) => [normalizeTag(decision.tag), decision]));
@@ -21496,6 +21662,7 @@ var SubmitSchema = z26.object({
   state: z26.string().trim().length(2).transform((value) => value.toLowerCase()),
   businessName: z26.string().trim().min(2).max(160),
   websiteUrl: z26.url().refine((value) => /^https?:\/\//.test(value), "websiteUrl must use http or https"),
+  schemaOrgType: LocalSourcebookSchemaTypeSchema.optional(),
   slug: z26.string().trim().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/).max(100).optional(),
   idempotencyKey: z26.string().trim().min(8).max(200).optional()
 }).strict();
@@ -21506,6 +21673,18 @@ var ValidateWriteSchema = z26.object({
   tagDecisions: z26.array(DirectoryTagDecisionSchema).max(20).optional()
 }).strict();
 var CaptureWriteSchema = ValidateWriteSchema.extend({ idempotencyKey: z26.string().trim().min(8).max(200).optional() });
+function withCanonicalLocalSourcebookUrls(listing) {
+  const category = z26.enum(LOCAL_SOURCEBOOK_CATEGORIES).safeParse(listing.category);
+  const state = typeof listing.state === "string" ? listing.state : "";
+  const listingSlug = typeof listing.slug === "string" ? listing.slug : "";
+  if (!category.success || !state || !listingSlug) return listing;
+  const publicUrls = localSourcebookPublicUrls(category.data, state, listingSlug);
+  return {
+    ...listing,
+    canonicalPaths: { profile: publicUrls.profilePath, reviews: publicUrls.reviewsPath },
+    canonicalUrls: { profile: publicUrls.profileUrl, reviews: publicUrls.reviewsUrl }
+  };
+}
 function acquisitionPlan(websiteUrl) {
   return {
     website: { startUrl: websiteUrl, mode: "broad_site_crawl", capture: ["homepage", "services", "products", "locations", "service_areas", "about", "team_staff", "contact", "policies"] },
@@ -21540,13 +21719,19 @@ localSourcebookApp.post("/capture", createApiKeyAuth(), async (c) => {
   if (!parsed.success) return c.json({ error: "invalid_capture_request", issues: parsed.error.issues }, 400);
   const validation = await validateLocalSourcebookWrite(parsed.data);
   if (!validation.valid) return c.json({ error: "invalid_directory_write", ...validation }, 400);
+  let billing = null;
+  let persisted = false;
   try {
     const identity = validation.normalizedIdentity;
-    if (!parsed.data.idempotencyKey && !identity.idempotencyKey) {
+    const idempotencyKey3 = parsed.data.idempotencyKey ?? identity.idempotencyKey;
+    if (!idempotencyKey3) {
       return c.json({ error: "idempotency_key_required", message: "A stable idempotencyKey is required for a new Local Sourcebook capture." }, 400);
     }
     const listingSlug = identity.slug ?? slug(identity.businessName);
     const publicUrls = localSourcebookPublicUrls(identity.category, identity.state, listingSlug);
+    const charged = await chargeListingWrite({ surface: "local_sourcebook", kind: "create", userId: Number(user.id), idempotencyKey: idempotencyKey3 });
+    if ("insufficient" in charged) return c.json(charged.insufficient, 402);
+    billing = charged;
     const submission = await createLocalSourcebookSubmission({
       ownerUserId: Number(user.id),
       category: identity.category,
@@ -21554,7 +21739,9 @@ localSourcebookApp.post("/capture", createApiKeyAuth(), async (c) => {
       slug: listingSlug,
       businessName: identity.businessName,
       websiteUrl: identity.websiteUrl,
-      idempotencyKey: parsed.data.idempotencyKey ?? identity.idempotencyKey,
+      schemaOrgType: identity.schemaOrgType,
+      idempotencyKey: idempotencyKey3,
+      billing: { kind: billing.kind, credits: billing.credits, amountMc: billing.amountMc, debitKey: billing.debitKey },
       payload: {
         id: "",
         category: identity.category,
@@ -21562,6 +21749,7 @@ localSourcebookApp.post("/capture", createApiKeyAuth(), async (c) => {
         slug: listingSlug,
         name: identity.businessName,
         websiteUrl: identity.websiteUrl,
+        schemaOrgType: identity.schemaOrgType,
         tags: validation.normalizedTags,
         canonicalPaths: { profile: publicUrls.profilePath, reviews: publicUrls.reviewsPath },
         canonicalUrls: { profile: publicUrls.profileUrl, reviews: publicUrls.reviewsUrl },
@@ -21572,10 +21760,12 @@ localSourcebookApp.post("/capture", createApiKeyAuth(), async (c) => {
         reviews: []
       }
     });
+    persisted = true;
     await persistLocalSourcebookTags(submission.id, Number(user.id), validation.normalizedTags, parsed.data.tagDecisions);
     const dispatched = await dispatchLocalSourcebookAcquisition(submission.id).catch(() => false);
-    return c.json({ ok: true, valid: true, submission, publicUrls: localSourcebookPublicationLinks(submission), normalizedTags: validation.normalizedTags, acquisition: { queued: true, dispatched }, acquisitionPlan: acquisitionPlan(identity.websiteUrl) }, 202);
+    return c.json({ ok: true, valid: true, submission, publicUrls: localSourcebookPublicationLinks(submission), normalizedTags: validation.normalizedTags, acquisition: { queued: true, dispatched }, acquisitionPlan: acquisitionPlan(identity.websiteUrl), billing: publicListingWriteBilling(billing) }, 202);
   } catch (error) {
+    if (billing && !persisted) await refundListingWrite(billing, "Local Sourcebook creation failed before persistence.").catch(() => null);
     const message = error instanceof Error ? error.message : String(error);
     const conflict = message.includes("revision conflict") ? "revision_conflict" : message.includes("idempotency key conflicts") ? "idempotency_conflict" : null;
     return c.json({ error: conflict ?? "capture_failed", message }, conflict ? 409 : 400);
@@ -21587,13 +21777,22 @@ localSourcebookApp.post("/submissions", createApiKeyAuth(), async (c) => {
   const parsed = SubmitSchema.safeParse(await c.req.json().catch(() => null));
   if (!parsed.success) return c.json({ error: "invalid_submission", issues: parsed.error.issues }, 400);
   const input = parsed.data;
+  if (!input.idempotencyKey) return c.json({ error: "idempotency_key_required", message: "A stable idempotencyKey is required for a new Local Sourcebook listing." }, 400);
   const listingSlug = input.slug ?? slug(input.businessName);
+  const schemaOrgType = input.schemaOrgType ?? defaultLocalSourcebookSchemaType(input.category);
   const publicUrls = localSourcebookPublicUrls(input.category, input.state, listingSlug);
+  let billing = null;
+  let persisted = false;
   try {
+    const charged = await chargeListingWrite({ surface: "local_sourcebook", kind: "create", userId: Number(user.id), idempotencyKey: input.idempotencyKey });
+    if ("insufficient" in charged) return c.json(charged.insufficient, 402);
+    billing = charged;
     const submission = await createLocalSourcebookSubmission({
       ownerUserId: Number(user.id),
       ...input,
+      schemaOrgType,
       slug: listingSlug,
+      billing: { kind: billing.kind, credits: billing.credits, amountMc: billing.amountMc, debitKey: billing.debitKey },
       payload: {
         id: "",
         category: input.category,
@@ -21601,6 +21800,7 @@ localSourcebookApp.post("/submissions", createApiKeyAuth(), async (c) => {
         slug: listingSlug,
         name: input.businessName,
         websiteUrl: input.websiteUrl,
+        schemaOrgType,
         canonicalPaths: { profile: publicUrls.profilePath, reviews: publicUrls.reviewsPath },
         canonicalUrls: { profile: publicUrls.profileUrl, reviews: publicUrls.reviewsUrl },
         verificationState: "submitted",
@@ -21610,9 +21810,11 @@ localSourcebookApp.post("/submissions", createApiKeyAuth(), async (c) => {
         reviews: []
       }
     });
+    persisted = true;
     const dispatched = await dispatchLocalSourcebookAcquisition(submission.id).catch(() => false);
-    return c.json({ ok: true, submission, publicUrls: localSourcebookPublicationLinks(submission), acquisition: { queued: true, dispatched }, acquisitionPlan: acquisitionPlan(input.websiteUrl) }, 202);
+    return c.json({ ok: true, submission, publicUrls: localSourcebookPublicationLinks(submission), acquisition: { queued: true, dispatched }, acquisitionPlan: acquisitionPlan(input.websiteUrl), billing: publicListingWriteBilling(billing) }, 202);
   } catch (error) {
+    if (billing && !persisted) await refundListingWrite(billing, "Local Sourcebook creation failed before persistence.").catch(() => null);
     return c.json({ error: "submission_conflict", message: error instanceof Error ? error.message : String(error) }, 409);
   }
 });
@@ -21629,22 +21831,45 @@ localSourcebookApp.on(["PATCH", "POST"], "/submissions/:id/draft", createApiKeyA
 localSourcebookApp.post("/submissions/:id/refresh", createApiKeyAuth(), async (c) => {
   const user = c.get("user");
   if (!user.subscription_tier) return c.json({ error: "subscription_required" }, 402);
+  const userId = Number(user.id);
+  const existing = await getLocalSourcebookSubmission(c.req.param("id"), userId);
+  if (!existing) return c.json({ error: "not_found" }, 404);
+  if (existing.status === "rejected" || existing.status === "unpublished") {
+    return c.json({ error: "moderated_listing", message: `A ${existing.status} Local Sourcebook listing cannot be refreshed by its owner.` }, 409);
+  }
+  if (existing.status === "queued" || existing.status === "enriching") {
+    return c.json({ error: "acquisition_in_progress", message: "This listing already has an acquisition in progress." }, 409);
+  }
+  const idempotencyKey3 = `refresh:${existing.id}:revision:${existing.draftRevision}`;
+  let billing = null;
   try {
-    const submission = await queueLocalSourcebookRefresh(c.req.param("id"), Number(user.id));
-    if (!submission) return c.json({ error: "not_found" }, 404);
+    const charged = await chargeListingWrite({ surface: "local_sourcebook", kind: "edit", userId, idempotencyKey: idempotencyKey3 });
+    if ("insufficient" in charged) return c.json(charged.insufficient, 402);
+    billing = charged;
+    const submission = await queueLocalSourcebookRefresh(c.req.param("id"), userId, {
+      kind: billing.kind,
+      credits: billing.credits,
+      amountMc: billing.amountMc,
+      debitKey: billing.debitKey
+    });
+    if (!submission) {
+      await refundListingWrite(billing, "Local Sourcebook listing was not found before refresh persistence.").catch(() => null);
+      return c.json({ error: "not_found" }, 404);
+    }
     const dispatched = await dispatchLocalSourcebookAcquisition(submission.id).catch(() => false);
-    return c.json({ ok: true, submission, publicUrls: localSourcebookPublicationLinks(submission), acquisition: { queued: true, dispatched }, acquisitionPlan: acquisitionPlan(submission.websiteUrl) }, 202);
+    return c.json({ ok: true, submission, publicUrls: localSourcebookPublicationLinks(submission), acquisition: { queued: true, dispatched }, acquisitionPlan: acquisitionPlan(submission.websiteUrl), billing: publicListingWriteBilling(billing) }, 202);
   } catch (error) {
+    if (billing) await refundListingWrite(billing, "Local Sourcebook refresh failed before persistence.").catch(() => null);
     return c.json({ error: "moderated_listing", message: error instanceof Error ? error.message : String(error) }, 409);
   }
 });
 var publicLocalSourcebookApp = new Hono17();
-publicLocalSourcebookApp.get("/", async (c) => c.json({ ok: true, listings: await listAllPublicLocalSourcebook() }));
-publicLocalSourcebookApp.get("/:category", async (c) => c.json({ ok: true, listings: await listAllPublicLocalSourcebook(c.req.param("category")) }));
-publicLocalSourcebookApp.get("/:category/:state", async (c) => c.json({ ok: true, listings: await listPublicLocalSourcebook(c.req.param("category"), c.req.param("state").toLowerCase()) }));
+publicLocalSourcebookApp.get("/", async (c) => c.json({ ok: true, listings: (await listAllPublicLocalSourcebook()).map(withCanonicalLocalSourcebookUrls) }));
+publicLocalSourcebookApp.get("/:category", async (c) => c.json({ ok: true, listings: (await listAllPublicLocalSourcebook(c.req.param("category"))).map(withCanonicalLocalSourcebookUrls) }));
+publicLocalSourcebookApp.get("/:category/:state", async (c) => c.json({ ok: true, listings: (await listPublicLocalSourcebook(c.req.param("category"), c.req.param("state").toLowerCase())).map(withCanonicalLocalSourcebookUrls) }));
 publicLocalSourcebookApp.get("/:category/:state/:slug", async (c) => {
   const listing = await getPublicLocalSourcebook(c.req.param("category"), c.req.param("state").toLowerCase(), c.req.param("slug"));
-  return listing ? c.json({ ok: true, listing }) : c.json({ error: "not_found" }, 404);
+  return listing ? c.json({ ok: true, listing: withCanonicalLocalSourcebookUrls(listing) }) : c.json({ error: "not_found" }, 404);
 });
 var adminLocalSourcebookApp = new Hono17();
 adminLocalSourcebookApp.use("*", adminAuth);
@@ -31006,6 +31231,12 @@ async function prepareCommonsEntity(input, user) {
       writePath: "commons_prepare_entity -> commons_validate_entity -> commons_submit_entity"
     },
     contract,
+    billing: {
+      validationCredits: LISTING_WRITE_RATE_POLICY.validationCredits,
+      createCredits: LISTING_WRITE_RATE_POLICY.create.credits,
+      editCredits: LISTING_WRITE_RATE_POLICY.edit.credits,
+      chargeEvent: LISTING_WRITE_RATE_POLICY.chargeEvent
+    },
     duplicateCandidates,
     tagResolutions,
     headingPlan: {
@@ -31020,7 +31251,8 @@ async function prepareCommonsEntity(input, user) {
       "Use the returned profile as a contract, not a rigid empty template: do not include History, Reception, Pricing, Timeline, or similar sections unless source evidence supports them.",
       "Write neutral encyclopedia prose. Do not paste raw scrape Markdown, marketing layout fragments, or empty/filler headings.",
       "Attach a featured image for auto-publish eligibility, preserve original URL/source byline/relCanonical when republishing, and put media assets in the media array.",
-      "Call commons_validate_entity with the composed payload before commons_submit_entity."
+      "Call commons_validate_entity with the composed payload before commons_submit_entity.",
+      "Validation is free. Submitting a new entity costs 10 Credits; submitting an edit to an existing entity costs 2 Credits."
     ]
   };
 }
@@ -31109,6 +31341,14 @@ async function getCommonsEntity(idOrSlug) {
   });
   return result.rows[0] ? rowToEntity(result.rows[0]) : null;
 }
+async function classifyCommonsWrite(input, user) {
+  await ensureCommonsSchema();
+  const normalized = normalizeSubmitInput(input);
+  const existingProposal = await findProposalByIdempotency(user.id, normalized.idempotencyKey);
+  if (existingProposal) return existingProposal.proposalType === "edit_entity" ? "edit" : "create";
+  const existing = await findEntityBySlugOrIdAnyStatus(normalized.slug, normalized.entityId);
+  return existing ? "edit" : "create";
+}
 async function submitCommonsEntity(input, user) {
   await ensureCommonsSchema();
   const normalized = normalizeSubmitInput(input);
@@ -31373,7 +31613,8 @@ function commonsDatabaseReport() {
       normalWorkflow: ["commons_prepare_entity", "commons_validate_entity", "commons_submit_entity"],
       writesCreate: ["commons_proposals", "commons_ledger", "commons_entities when accepted"],
       safeAutoPublish: "New non-conflicting entities with title, description, featured image, and body/source evidence.",
-      conflictBehavior: "Existing entity edits require baseRevision. Otherwise the proposal is pending_review."
+      conflictBehavior: "Existing entity edits require baseRevision. Otherwise the proposal is pending_review.",
+      billing: { validationCredits: 0, createCredits: LISTING_WRITE_RATE_POLICY.create.credits, editCredits: LISTING_WRITE_RATE_POLICY.edit.credits }
     },
     searchCorpus: ["title", "disambiguationName", "description", "tags", "keywords", "relatedEntities", "bodyMarkdown", "sections", "media", "source metadata", "jsonLd"],
     indexing: commonsIndexingPolicy(),
@@ -32664,10 +32905,22 @@ commonsApp.post("/entities/validate", auth2, async (c) => {
 commonsApp.post("/entities/propose", auth2, async (c) => {
   const parsed = SubmitEntitySchema.safeParse(await c.req.json().catch(() => ({})));
   if (!parsed.success) return validationError(c, parsed.error);
+  let billing = null;
   try {
+    const user = c.get("user");
+    const kind = await classifyCommonsWrite(parsed.data, user);
+    const charged = await chargeListingWrite({
+      surface: "transparent_commons",
+      kind,
+      userId: Number(user.id),
+      idempotencyKey: parsed.data.idempotencyKey
+    });
+    if ("insufficient" in charged) return c.json(charged.insufficient, 402);
+    billing = charged;
     const result = await submitCommonsEntity(parsed.data, c.get("user"));
-    return c.json({ ok: true, data: result }, result.applied ? 201 : 202);
+    return c.json({ ok: true, data: result, billing: publicListingWriteBilling(billing) }, result.applied ? 201 : 202);
   } catch (error) {
+    if (billing) await refundListingWrite(billing, "Transparent Commons write failed before persistence.").catch(() => null);
     if (error instanceof CommonsRepositoryError) {
       return c.json({ ok: false, error: error.code, message: error.message }, repositoryStatus(error));
     }
@@ -40751,7 +41004,7 @@ app.get("/cron/tick", async (c) => {
   if (!process.env.CRON_SECRET || secret2 !== `Bearer ${process.env.CRON_SECRET}`) {
     return c.json({ error: "Unauthorized" }, 401);
   }
-  const { drainQueue } = await import("./worker-73AYU4IK.js");
+  const { drainQueue } = await import("./worker-4LZGRHDA.js");
   const budget = { maxJobs: 10, deadlineMs: Date.now() + 28e4 };
   const workflowDispatchResult = await dispatchDueWorkflowSchedules(`${new URL(c.req.url).protocol}//${new URL(c.req.url).host}`);
   const [results, sweepResult, reapResult, expiredResult, blobCleanup, connectedDataArtifactCleanup, connectedAccountBilling, directoryWorkflowDispatch, directoryWorkflowReconciliation, directoryArtifactCleanup, siteExtractArtifactCleanup, siteExtractRedispatch, siteExtractReconciliation, paaHarvestRedispatch, paaHarvestReconciliation, localSourcebookRedispatch] = await Promise.all([
@@ -40806,8 +41059,8 @@ app.post("/api/internal/extract-refinalize/:id", async (c) => {
     finishExtractJob: finishExtractJob2,
     terminalExtractJobStatus: terminalExtractJobStatus2,
     extractJobLimitInfo: extractJobLimitInfo2
-  } = await import("./site-extract-repository-CKCJDP7N.js");
-  const { assembleExtractArtifacts } = await import("./extract-bundle-U3MNYDKC.js");
+  } = await import("./site-extract-repository-G723PZIL.js");
+  const { assembleExtractArtifacts } = await import("./extract-bundle-DYMQRQWG.js");
   const existing = await getExtractJob2(jobId2);
   if (!existing) return c.json({ error: "job not found" }, 404);
   if (existing.status !== "failed") {
@@ -40834,7 +41087,7 @@ app.post("/api/internal/extract-refinalize/:id", async (c) => {
   if (!updated) return c.json({ error: "job state changed during re-finalization" }, 409);
   let settlement = "already_settled_or_refunded";
   if (job.billedMc == null && job.userId != null) {
-    const { settleExtractJob: settleExtractJob3, countSuccessfulPages: countSuccessfulPages2 } = await import("./site-extract-repository-CKCJDP7N.js");
+    const { settleExtractJob: settleExtractJob3, countSuccessfulPages: countSuccessfulPages2 } = await import("./site-extract-repository-G723PZIL.js");
     const heldMc = Number(job.options.heldMc ?? 0);
     const successful = await countSuccessfulPages2(jobId2);
     const usedMc = Math.min(successful * MC_COSTS.page_scrape, heldMc);
@@ -41018,4 +41271,4 @@ app.get("/blog/:slug/", (c) => {
 export {
   app
 };
-//# sourceMappingURL=server-JJLFY46K.js.map
+//# sourceMappingURL=server-7B75SDNG.js.map