@aglyn/aglyn 1.0.0-beta.218 → 1.0.0-beta.220

package/src/lib/plugin-manager/commerce-zone-props.d.ts

@@ -1,172 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-/**
- * The props the commerce plugin's zones hand each widget (AGL-2916): the
- * product editor, the products hub and the CSV import dialog.
- *
- * Types only. `feature-plugins.ts` re-exports them with `export type`, which
- * TypeScript erases, so a published page that imports the zone catalog does
- * not carry them.
- */
-/** A product type, as the commerce catalog names it. */
-export type ConsoleProductType = 'physical' | 'digital' | 'service';
-/** A product option axis: its name and the values a shopper picks from. */
-export interface ConsoleProductOption {
-    name: string;
-    values: string[];
-}
-/** A product as the commerce editor holds it: saved, or staged and unsaved (AGL-2916). */
-export interface ConsoleProductDraft {
-    /** `null` for a product nobody has saved yet. */
-    id: string | null;
-    name: string;
-    type: ConsoleProductType;
-    description: string;
-    tags: string[];
-    categoryIds: string[];
-    options: ConsoleProductOption[];
-    /** The product's media, in order; the first is the photo the storefront leads with. */
-    mediaUrls: string[];
-    seoTitle: string;
-    seoDescription: string;
-}
-/**
- * Copy a widget proposes for one product (AGL-2916). A field left out is left
- * alone; `optionNames` renames the product's options in order, keeping every
- * variant, and is ignored unless it names each option once.
- */
-export interface ConsoleProductCopyValues {
-    description?: string;
-    tags?: string[];
-    categoryIds?: string[];
-    optionNames?: string[];
-    seoTitle?: string;
-    seoDescription?: string;
-}
-/**
- * What the `productEditor` zone hands each widget (AGL-2916): the product as
- * the editor holds it, and `proposeValues`, which stages copy in the editor as
- * unsaved edits. The zone sits under the product's description, tags and
- * categories, hosted by the commerce plugin through `useConsoleWidgetSlot` as
- * the editor's search listing hosts `seoFields`. A widget here proposes and
- * never writes: Save product is the write, with the guards it carries.
- */
-export interface ConsoleProductEditorZoneProps {
-    hostId: string;
-    /** The org the page names; `undefined` where the host does not know it. */
-    orgId: string | undefined;
-    product: ConsoleProductDraft;
-    /** The site's categories, as the editor's picker lists them. */
-    categories: ReadonlyArray<{
-        id: string;
-        name: string;
-    }>;
-    /**
-     * Stages `values` in the editor as unsaved edits under `key`. Save product
-     * is what stores them; a widget never writes the product itself.
-     */
-    proposeValues: (values: ConsoleProductCopyValues, key: string) => void;
-}
-/** A catalog row as the products hub holds it (AGL-2916). */
-export interface ConsoleProductSummary {
-    id: string;
-    name: string;
-    status: 'draft' | 'active' | 'archived';
-    /** Whether a variant of the product has no price yet. */
-    priceMissing: boolean;
-    /** Whether the product has a photo. */
-    hasPhoto: boolean;
-}
-/** A new product a widget asks the hub to create, always as a draft with no price (AGL-2916). */
-export interface ConsoleProposedProduct {
-    name: string;
-    type: ConsoleProductType;
-    description: string;
-    tags: string[];
-    options: ConsoleProductOption[];
-    seoTitle: string;
-    seoDescription: string;
-}
-/** A discount a widget asks the hub to create, always switched off (AGL-2916). */
-export interface ConsoleProposedDiscount {
-    name: string;
-    /** The code a shopper types, or `null` for a discount that applies on its own. */
-    code: string | null;
-    kind: 'percent' | 'fixed' | 'free_shipping';
-    valuePct: number | null;
-    valueCents: number | null;
-    minSubtotalCents: number | null;
-}
-/**
- * What the `productsHub` zone hands each widget (AGL-2916): the catalog rows
- * the hub holds, the products its latest import created, and the hub's own
- * writes a widget may ask it to make — copy onto saved products, new draft
- * products, categories and switched-off discounts. The zone sits above the
- * catalog table. Each write is the hub's, with its seed, allowance and slug
- * checks; a widget writes nothing itself. Every write
- * resolves once it is stored and throws with a message a person can act on
- * when the hub refuses it: an allowance the plan has no room for, a product
- * that is gone.
- *
- * The creates are safe to ask twice: a product or a category named like one
- * the site has, and a discount with the code (or, with no code, the name) of
- * one the site has, are passed over, so a proposal applied again, by anyone,
- * creates nothing it already created.
- */
-export interface ConsoleProductsHubZoneProps {
-    hostId: string;
-    /** The org the page names; `undefined` where the host does not know it. */
-    orgId: string | undefined;
-    /** The catalog rows the hub holds, in its order. */
-    products: readonly ConsoleProductSummary[];
-    /**
-     * The products the hub's latest CSV import created in this visit, and the
-     * options the `productImport` zone set for them; `null` before any import.
-     * `key` is new for each import.
-     */
-    lastImport: {
-        key: string;
-        productIds: readonly string[];
-        options: Readonly<Record<string, boolean>>;
-    } | null;
-    /** Writes copy onto a saved product, read fresh from the store. */
-    applyProductCopy: (productId: string, values: ConsoleProductCopyValues) => Promise<void>;
-    /** Creates each product as a draft with no price, and resolves with the ids it created. */
-    createProductDrafts: (products: readonly ConsoleProposedProduct[]) => Promise<string[]>;
-    /** Creates categories by name, and resolves with how many it created. */
-    createCategories: (names: readonly string[]) => Promise<number>;
-    /** Creates each discount switched off, and resolves with how many it created. */
-    createDiscountDrafts: (discounts: readonly ConsoleProposedDiscount[]) => Promise<number>;
-}
-/**
- * What the `productImport` zone hands each widget (AGL-2916), inside the
- * commerce CSV import dialog: how many products the import creates, and
- * options a widget sets for what happens to them once they land. The hub hands
- * the options, with the ids of the products the import created, to
- * `productsHub` as its `lastImport`.
- */
-export interface ConsoleProductImportZoneProps {
-    hostId: string;
-    /** The org the page names; `undefined` where the host does not know it. */
-    orgId: string | undefined;
-    /** How many products the import creates. */
-    count: number;
-    /** The options set for this import, by key. */
-    options: Readonly<Record<string, boolean>>;
-    /** Sets one option; the hub carries it to `productsHub` with what the import created. */
-    setOption: (key: string, on: boolean) => void;
-}

package/src/lib/plugin-manager/commerce-zone-props.js

@@ -1,31 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */ /**
- * The props the commerce plugin's zones hand each widget (AGL-2916): the
- * product editor, the products hub and the CSV import dialog.
- *
- * Types only. `feature-plugins.ts` re-exports them with `export type`, which
- * TypeScript erases, so a published page that imports the zone catalog does
- * not carry them.
- */ /** A product type, as the commerce catalog names it. */ /**
- * What the `productImport` zone hands each widget (AGL-2916), inside the
- * commerce CSV import dialog: how many products the import creates, and
- * options a widget sets for what happens to them once they land. The hub hands
- * the options, with the ids of the products the import created, to
- * `productsHub` as its `lastImport`.
- */ export { };
-
-//# sourceMappingURL=commerce-zone-props.js.map

package/src/lib/plugin-manager/commerce-zone-props.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/commerce-zone-props.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The props the commerce plugin's zones hand each widget (AGL-2916): the\n * product editor, the products hub and the CSV import dialog.\n *\n * Types only. `feature-plugins.ts` re-exports them with `export type`, which\n * TypeScript erases, so a published page that imports the zone catalog does\n * not carry them.\n */\n\n/** A product type, as the commerce catalog names it. */\nexport type ConsoleProductType = 'physical' | 'digital' | 'service'\n\n/** A product option axis: its name and the values a shopper picks from. */\nexport interface ConsoleProductOption {\n  name: string\n  values: string[]\n}\n\n/** A product as the commerce editor holds it: saved, or staged and unsaved (AGL-2916). */\nexport interface ConsoleProductDraft {\n  /** `null` for a product nobody has saved yet. */\n  id: string | null\n  name: string\n  type: ConsoleProductType\n  description: string\n  tags: string[]\n  categoryIds: string[]\n  options: ConsoleProductOption[]\n  /** The product's media, in order; the first is the photo the storefront leads with. */\n  mediaUrls: string[]\n  seoTitle: string\n  seoDescription: string\n}\n\n/**\n * Copy a widget proposes for one product (AGL-2916). A field left out is left\n * alone; `optionNames` renames the product's options in order, keeping every\n * variant, and is ignored unless it names each option once.\n */\nexport interface ConsoleProductCopyValues {\n  description?: string\n  tags?: string[]\n  categoryIds?: string[]\n  optionNames?: string[]\n  seoTitle?: string\n  seoDescription?: string\n}\n\n/**\n * What the `productEditor` zone hands each widget (AGL-2916): the product as\n * the editor holds it, and `proposeValues`, which stages copy in the editor as\n * unsaved edits. The zone sits under the product's description, tags and\n * categories, hosted by the commerce plugin through `useConsoleWidgetSlot` as\n * the editor's search listing hosts `seoFields`. A widget here proposes and\n * never writes: Save product is the write, with the guards it carries.\n */\nexport interface ConsoleProductEditorZoneProps {\n  hostId: string\n  /** The org the page names; `undefined` where the host does not know it. */\n  orgId: string | undefined\n  product: ConsoleProductDraft\n  /** The site's categories, as the editor's picker lists them. */\n  categories: ReadonlyArray<{ id: string; name: string }>\n  /**\n   * Stages `values` in the editor as unsaved edits under `key`. Save product\n   * is what stores them; a widget never writes the product itself.\n   */\n  proposeValues: (values: ConsoleProductCopyValues, key: string) => void\n}\n\n/** A catalog row as the products hub holds it (AGL-2916). */\nexport interface ConsoleProductSummary {\n  id: string\n  name: string\n  status: 'draft' | 'active' | 'archived'\n  /** Whether a variant of the product has no price yet. */\n  priceMissing: boolean\n  /** Whether the product has a photo. */\n  hasPhoto: boolean\n}\n\n/** A new product a widget asks the hub to create, always as a draft with no price (AGL-2916). */\nexport interface ConsoleProposedProduct {\n  name: string\n  type: ConsoleProductType\n  description: string\n  tags: string[]\n  options: ConsoleProductOption[]\n  seoTitle: string\n  seoDescription: string\n}\n\n/** A discount a widget asks the hub to create, always switched off (AGL-2916). */\nexport interface ConsoleProposedDiscount {\n  name: string\n  /** The code a shopper types, or `null` for a discount that applies on its own. */\n  code: string | null\n  kind: 'percent' | 'fixed' | 'free_shipping'\n  valuePct: number | null\n  valueCents: number | null\n  minSubtotalCents: number | null\n}\n\n/**\n * What the `productsHub` zone hands each widget (AGL-2916): the catalog rows\n * the hub holds, the products its latest import created, and the hub's own\n * writes a widget may ask it to make — copy onto saved products, new draft\n * products, categories and switched-off discounts. The zone sits above the\n * catalog table. Each write is the hub's, with its seed, allowance and slug\n * checks; a widget writes nothing itself. Every write\n * resolves once it is stored and throws with a message a person can act on\n * when the hub refuses it: an allowance the plan has no room for, a product\n * that is gone.\n *\n * The creates are safe to ask twice: a product or a category named like one\n * the site has, and a discount with the code (or, with no code, the name) of\n * one the site has, are passed over, so a proposal applied again, by anyone,\n * creates nothing it already created.\n */\nexport interface ConsoleProductsHubZoneProps {\n  hostId: string\n  /** The org the page names; `undefined` where the host does not know it. */\n  orgId: string | undefined\n  /** The catalog rows the hub holds, in its order. */\n  products: readonly ConsoleProductSummary[]\n  /**\n   * The products the hub's latest CSV import created in this visit, and the\n   * options the `productImport` zone set for them; `null` before any import.\n   * `key` is new for each import.\n   */\n  lastImport: {\n    key: string\n    productIds: readonly string[]\n    options: Readonly<Record<string, boolean>>\n  } | null\n  /** Writes copy onto a saved product, read fresh from the store. */\n  applyProductCopy: (productId: string, values: ConsoleProductCopyValues) => Promise<void>\n  /** Creates each product as a draft with no price, and resolves with the ids it created. */\n  createProductDrafts: (products: readonly ConsoleProposedProduct[]) => Promise<string[]>\n  /** Creates categories by name, and resolves with how many it created. */\n  createCategories: (names: readonly string[]) => Promise<number>\n  /** Creates each discount switched off, and resolves with how many it created. */\n  createDiscountDrafts: (discounts: readonly ConsoleProposedDiscount[]) => Promise<number>\n}\n\n/**\n * What the `productImport` zone hands each widget (AGL-2916), inside the\n * commerce CSV import dialog: how many products the import creates, and\n * options a widget sets for what happens to them once they land. The hub hands\n * the options, with the ids of the products the import created, to\n * `productsHub` as its `lastImport`.\n */\nexport interface ConsoleProductImportZoneProps {\n  hostId: string\n  /** The org the page names; `undefined` where the host does not know it. */\n  orgId: string | undefined\n  /** How many products the import creates. */\n  count: number\n  /** The options set for this import, by key. */\n  options: Readonly<Record<string, boolean>>\n  /** Sets one option; the hub carries it to `productsHub` with what the import created. */\n  setOption: (key: string, on: boolean) => void\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;CAOC,GAED,sDAAsD,GAwItD;;;;;;CAMC,GACD,WAUC"}

package/src/lib/plugin-manager/plugin-metered-lines.d.ts

@@ -1,97 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-/** One plugin's claim on one line. */
-export interface PluginMeteredLineClaim {
-    /**
-     * The line the sweep knows, e.g. the assist-overage line. Core's own name
-     * for a figure it already computes — not a plugin's internal name for it.
-     */
-    lineId: string;
-    /** The plugin that bills it. */
-    pluginId: string;
-    /**
-     * The first month (`YYYY-MM`) the plugin bills the line for, or `null`
-     * while the plugin has registered the claim but not yet been switched on.
-     *
-     * A function rather than a value because the answer comes from deployment
-     * configuration that can change without a restart, and because a claim
-     * evaluated once at boot would pin the cutover to whenever the process
-     * happened to start.
-     */
-    billsFrom: () => string | null;
-    /**
-     * Called once per workspace for a month this sweep has CLOSED, so a plugin
-     * billing the line can settle what is left of it.
-     *
-     * A plugin that charges as usage accrues always has a remainder: the part
-     * that never reached its threshold before the month ended. Something has to
-     * bill that, and the sweep that closes the month is the one thing that
-     * already knows every workspace, its month and its Stripe customer — which
-     * is why this is a hook here rather than a second cron with a second
-     * schedule to keep in step with this one.
-     *
-     * Called whether or not the meter reported for the workspace, because the
-     * remainder is owed either way. Errors are logged and never the sweep's:
-     * this is money the plugin bills, and failing the platform's own metering
-     * over it would be the larger loss. A plugin makes it idempotent; it is
-     * called again every day the sweep runs.
-     */
-    closeMonth?: (context: PluginMeteredLineMonthContext) => Promise<void>;
-}
-/** What a plugin is told about one workspace's closed month. */
-export interface PluginMeteredLineMonthContext {
-    orgId: string;
-    /** `YYYY-MM`, the month that closed. */
-    month: string;
-    /** The workspace's own document, as the sweep already read it. */
-    org: Record<string, unknown>;
-    /** Its Stripe customer, or `null` when it has none. */
-    stripeCustomerId: string | null;
-}
-/**
- * Claims a meter line. One plugin per line: a second plugin claiming a line
- * another already holds throws, because two plugins each believing they bill
- * a line is how it reaches no invoice at all.
- *
- * The same plugin re-registering replaces its own claim, so a module
- * evaluated twice leaves one claim rather than two.
- */
-export declare function registerPluginMeteredLine(claim: Omit<PluginMeteredLineClaim, 'pluginId'> & {
-    pluginId?: string;
-}): void;
-/**
- * Does a plugin bill this line for this month, so the sweep must leave it
- * out of the meter figure?
- *
- * A claim whose `billsFrom` throws answers `false` and logs: the sweep is
- * the only thing that bills the line while a claim is broken, and a throw
- * that propagated would fail the whole month's billing for every workspace.
- */
-export declare function pluginBillsMeteredLine(lineId: string, month: string): boolean;
-/**
- * Runs the claiming plugin's close-out for one workspace's closed month.
- *
- * `false` when no plugin claims the line, when it does not bill this month,
- * or when it registered no close-out — three different "nothing happened"s
- * that the sweep does not need to tell apart, and the plugin is the only
- * thing that could.
- */
-export declare function runPluginMeteredLineClose(lineId: string, context: PluginMeteredLineMonthContext): Promise<boolean>;
-/** The plugin billing a line, for diagnostics and staff readouts. */
-export declare function pluginMeteredLineOwner(lineId: string): string | null;
-/** Test seam: forget every claim. */
-export declare function resetPluginMeteredLinesForTests(): void;

package/src/lib/plugin-manager/plugin-metered-lines.js

@@ -1,123 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */ /**
- * A METER LINE A PLUGIN BILLS FOR ITSELF (AGL-3011).
- *
- * The monthly usage sweep prices several lines into one figure and posts it
- * as a single Stripe meter event. A plugin that bills one of those lines its
- * own way — charging it as it accrues, say — must have that line LEFT OUT of
- * the meter figure from the month it takes over, or the customer is billed
- * for it twice.
- *
- * That claim is what this registry holds: a line id, the plugin that owns
- * the billing of it, and the first month from which the plugin bills it. The
- * sweep asks by line id and gets a yes or a no. It never learns how the
- * plugin bills, and the plugin never edits the sweep.
- *
- * ## Only the billing moves, never the measurement
- *
- * A claimed line is still measured, still priced and still written to the
- * month's audit fields. What changes is whether its dollars enter the figure
- * the meter event carries. "We stopped billing it here" and "we stopped
- * counting it" must stay different facts, or a claim would erase a month of
- * usage history along with its invoice line.
- *
- * ## Unclaimed is the safe answer
- *
- * A line nobody claimed, a month before the claim's start, an unparseable
- * start month and a plugin that failed to register all answer the same way:
- * the sweep bills the line as it always has. Every failure mode therefore
- * bills through the channel that already works, rather than through neither.
- */ import { getRegisteringPluginId } from "../app-utils/registering-plugin.js";
-const claims = new Map();
-/**
- * Claims a meter line. One plugin per line: a second plugin claiming a line
- * another already holds throws, because two plugins each believing they bill
- * a line is how it reaches no invoice at all.
- *
- * The same plugin re-registering replaces its own claim, so a module
- * evaluated twice leaves one claim rather than two.
- */ export function registerPluginMeteredLine(claim) {
-    var _ref, _getRegisteringPluginId;
-    const pluginId = ((_ref = (_getRegisteringPluginId = getRegisteringPluginId()) != null ? _getRegisteringPluginId : claim.pluginId) != null ? _ref : '').trim();
-    if (!pluginId) {
-        throw new Error(`metered line "${claim.lineId}" claimed with no owner: pass ` + '{ pluginId } when registering outside a plugin register fn');
-    }
-    const held = claims.get(claim.lineId);
-    if (held && held.pluginId !== pluginId) {
-        throw new Error(`metered line "${claim.lineId}" is already billed by plugin ` + `"${held.pluginId}"; "${pluginId}" cannot claim it too`);
-    }
-    claims.set(claim.lineId, {
-        lineId: claim.lineId,
-        pluginId,
-        billsFrom: claim.billsFrom,
-        closeMonth: claim.closeMonth
-    });
-}
-/**
- * Does a plugin bill this line for this month, so the sweep must leave it
- * out of the meter figure?
- *
- * A claim whose `billsFrom` throws answers `false` and logs: the sweep is
- * the only thing that bills the line while a claim is broken, and a throw
- * that propagated would fail the whole month's billing for every workspace.
- */ export function pluginBillsMeteredLine(lineId, month) {
-    const claim = claims.get(lineId);
-    if (!claim) return false;
-    let from;
-    try {
-        from = claim.billsFrom();
-    } catch (error) {
-        console.error(`[plugins] ${claim.pluginId} failed to answer for ${lineId}`, error);
-        return false;
-    }
-    const start = String(from != null ? from : '').trim();
-    if (!/^\d{4}-\d{2}$/.test(start)) return false;
-    if (!/^\d{4}-\d{2}$/.test(month)) return false;
-    // Zero-padded fixed-width `YYYY-MM` orders identically as a string and as
-    // a date; the format checks above are what make that true rather than
-    // lucky. The same comparison `billsEmailSendOverage` makes on its own gate.
-    return month >= start;
-}
-/**
- * Runs the claiming plugin's close-out for one workspace's closed month.
- *
- * `false` when no plugin claims the line, when it does not bill this month,
- * or when it registered no close-out — three different "nothing happened"s
- * that the sweep does not need to tell apart, and the plugin is the only
- * thing that could.
- */ export async function runPluginMeteredLineClose(lineId, context) {
-    const claim = claims.get(lineId);
-    if (!(claim == null ? void 0 : claim.closeMonth)) return false;
-    if (!pluginBillsMeteredLine(lineId, context.month)) return false;
-    try {
-        await claim.closeMonth(context);
-        return true;
-    } catch (error) {
-        console.error(`[plugins] ${claim.pluginId} failed to close ${lineId} for ${context.orgId}`, error);
-        return false;
-    }
-}
-/** The plugin billing a line, for diagnostics and staff readouts. */ export function pluginMeteredLineOwner(lineId) {
-    var _ref;
-    var _claims_get;
-    return (_ref = (_claims_get = claims.get(lineId)) == null ? void 0 : _claims_get.pluginId) != null ? _ref : null;
-}
-/** Test seam: forget every claim. */ export function resetPluginMeteredLinesForTests() {
-    claims.clear();
-}
-
-//# sourceMappingURL=plugin-metered-lines.js.map

package/src/lib/plugin-manager/plugin-metered-lines.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-metered-lines.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * A METER LINE A PLUGIN BILLS FOR ITSELF (AGL-3011).\n *\n * The monthly usage sweep prices several lines into one figure and posts it\n * as a single Stripe meter event. A plugin that bills one of those lines its\n * own way — charging it as it accrues, say — must have that line LEFT OUT of\n * the meter figure from the month it takes over, or the customer is billed\n * for it twice.\n *\n * That claim is what this registry holds: a line id, the plugin that owns\n * the billing of it, and the first month from which the plugin bills it. The\n * sweep asks by line id and gets a yes or a no. It never learns how the\n * plugin bills, and the plugin never edits the sweep.\n *\n * ## Only the billing moves, never the measurement\n *\n * A claimed line is still measured, still priced and still written to the\n * month's audit fields. What changes is whether its dollars enter the figure\n * the meter event carries. \"We stopped billing it here\" and \"we stopped\n * counting it\" must stay different facts, or a claim would erase a month of\n * usage history along with its invoice line.\n *\n * ## Unclaimed is the safe answer\n *\n * A line nobody claimed, a month before the claim's start, an unparseable\n * start month and a plugin that failed to register all answer the same way:\n * the sweep bills the line as it always has. Every failure mode therefore\n * bills through the channel that already works, rather than through neither.\n */\n\nimport { getRegisteringPluginId } from '../app-utils/registering-plugin'\n\n/** One plugin's claim on one line. */\nexport interface PluginMeteredLineClaim {\n  /**\n   * The line the sweep knows, e.g. the assist-overage line. Core's own name\n   * for a figure it already computes — not a plugin's internal name for it.\n   */\n  lineId: string\n  /** The plugin that bills it. */\n  pluginId: string\n  /**\n   * The first month (`YYYY-MM`) the plugin bills the line for, or `null`\n   * while the plugin has registered the claim but not yet been switched on.\n   *\n   * A function rather than a value because the answer comes from deployment\n   * configuration that can change without a restart, and because a claim\n   * evaluated once at boot would pin the cutover to whenever the process\n   * happened to start.\n   */\n  billsFrom: () => string | null\n  /**\n   * Called once per workspace for a month this sweep has CLOSED, so a plugin\n   * billing the line can settle what is left of it.\n   *\n   * A plugin that charges as usage accrues always has a remainder: the part\n   * that never reached its threshold before the month ended. Something has to\n   * bill that, and the sweep that closes the month is the one thing that\n   * already knows every workspace, its month and its Stripe customer — which\n   * is why this is a hook here rather than a second cron with a second\n   * schedule to keep in step with this one.\n   *\n   * Called whether or not the meter reported for the workspace, because the\n   * remainder is owed either way. Errors are logged and never the sweep's:\n   * this is money the plugin bills, and failing the platform's own metering\n   * over it would be the larger loss. A plugin makes it idempotent; it is\n   * called again every day the sweep runs.\n   */\n  closeMonth?: (context: PluginMeteredLineMonthContext) => Promise<void>\n}\n\n/** What a plugin is told about one workspace's closed month. */\nexport interface PluginMeteredLineMonthContext {\n  orgId: string\n  /** `YYYY-MM`, the month that closed. */\n  month: string\n  /** The workspace's own document, as the sweep already read it. */\n  org: Record<string, unknown>\n  /** Its Stripe customer, or `null` when it has none. */\n  stripeCustomerId: string | null\n}\n\nconst claims = new Map<string, PluginMeteredLineClaim>()\n\n/**\n * Claims a meter line. One plugin per line: a second plugin claiming a line\n * another already holds throws, because two plugins each believing they bill\n * a line is how it reaches no invoice at all.\n *\n * The same plugin re-registering replaces its own claim, so a module\n * evaluated twice leaves one claim rather than two.\n */\nexport function registerPluginMeteredLine(\n  claim: Omit<PluginMeteredLineClaim, 'pluginId'> & { pluginId?: string },\n): void {\n  const pluginId = (getRegisteringPluginId() ?? claim.pluginId ?? '').trim()\n  if (!pluginId) {\n    throw new Error(\n      `metered line \"${claim.lineId}\" claimed with no owner: pass ` +\n        '{ pluginId } when registering outside a plugin register fn',\n    )\n  }\n  const held = claims.get(claim.lineId)\n  if (held && held.pluginId !== pluginId) {\n    throw new Error(\n      `metered line \"${claim.lineId}\" is already billed by plugin ` +\n        `\"${held.pluginId}\"; \"${pluginId}\" cannot claim it too`,\n    )\n  }\n  claims.set(claim.lineId, {\n    lineId: claim.lineId,\n    pluginId,\n    billsFrom: claim.billsFrom,\n    closeMonth: claim.closeMonth,\n  })\n}\n\n/**\n * Does a plugin bill this line for this month, so the sweep must leave it\n * out of the meter figure?\n *\n * A claim whose `billsFrom` throws answers `false` and logs: the sweep is\n * the only thing that bills the line while a claim is broken, and a throw\n * that propagated would fail the whole month's billing for every workspace.\n */\nexport function pluginBillsMeteredLine(lineId: string, month: string): boolean {\n  const claim = claims.get(lineId)\n  if (!claim) return false\n  let from: string | null\n  try {\n    from = claim.billsFrom()\n  } catch (error) {\n    console.error(`[plugins] ${claim.pluginId} failed to answer for ${lineId}`, error)\n    return false\n  }\n  const start = String(from ?? '').trim()\n  if (!/^\\d{4}-\\d{2}$/.test(start)) return false\n  if (!/^\\d{4}-\\d{2}$/.test(month)) return false\n  // Zero-padded fixed-width `YYYY-MM` orders identically as a string and as\n  // a date; the format checks above are what make that true rather than\n  // lucky. The same comparison `billsEmailSendOverage` makes on its own gate.\n  return month >= start\n}\n\n/**\n * Runs the claiming plugin's close-out for one workspace's closed month.\n *\n * `false` when no plugin claims the line, when it does not bill this month,\n * or when it registered no close-out — three different \"nothing happened\"s\n * that the sweep does not need to tell apart, and the plugin is the only\n * thing that could.\n */\nexport async function runPluginMeteredLineClose(\n  lineId: string,\n  context: PluginMeteredLineMonthContext,\n): Promise<boolean> {\n  const claim = claims.get(lineId)\n  if (!claim?.closeMonth) return false\n  if (!pluginBillsMeteredLine(lineId, context.month)) return false\n  try {\n    await claim.closeMonth(context)\n    return true\n  } catch (error) {\n    console.error(\n      `[plugins] ${claim.pluginId} failed to close ${lineId} for ${context.orgId}`,\n      error,\n    )\n    return false\n  }\n}\n\n/** The plugin billing a line, for diagnostics and staff readouts. */\nexport function pluginMeteredLineOwner(lineId: string): string | null {\n  return claims.get(lineId)?.pluginId ?? null\n}\n\n/** Test seam: forget every claim. */\nexport function resetPluginMeteredLinesForTests(): void {\n  claims.clear()\n}\n"],"names":["getRegisteringPluginId","claims","Map","registerPluginMeteredLine","claim","pluginId","trim","Error","lineId","held","get","set","billsFrom","closeMonth","pluginBillsMeteredLine","month","from","error","console","start","String","test","runPluginMeteredLineClose","context","orgId","pluginMeteredLineOwner","resetPluginMeteredLinesForTests","clear"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BC,GAED,SAASA,sBAAsB,QAAQ,qCAAiC;AAoDxE,MAAMC,SAAS,IAAIC;AAEnB;;;;;;;CAOC,GACD,OAAO,SAASC,0BACdC,KAAuE;QAErDJ,MAAAA;IAAlB,MAAMK,WAAW,EAACL,QAAAA,0BAAAA,oCAAAA,0BAA4BI,MAAMC,QAAQ,YAA1CL,OAA8C,IAAIM,IAAI;IACxE,IAAI,CAACD,UAAU;QACb,MAAM,IAAIE,MACR,CAAC,cAAc,EAAEH,MAAMI,MAAM,CAAC,8BAA8B,CAAC,GAC3D;IAEN;IACA,MAAMC,OAAOR,OAAOS,GAAG,CAACN,MAAMI,MAAM;IACpC,IAAIC,QAAQA,KAAKJ,QAAQ,KAAKA,UAAU;QACtC,MAAM,IAAIE,MACR,CAAC,cAAc,EAAEH,MAAMI,MAAM,CAAC,8BAA8B,CAAC,GAC3D,CAAC,CAAC,EAAEC,KAAKJ,QAAQ,CAAC,IAAI,EAAEA,SAAS,qBAAqB,CAAC;IAE7D;IACAJ,OAAOU,GAAG,CAACP,MAAMI,MAAM,EAAE;QACvBA,QAAQJ,MAAMI,MAAM;QACpBH;QACAO,WAAWR,MAAMQ,SAAS;QAC1BC,YAAYT,MAAMS,UAAU;IAC9B;AACF;AAEA;;;;;;;CAOC,GACD,OAAO,SAASC,uBAAuBN,MAAc,EAAEO,KAAa;IAClE,MAAMX,QAAQH,OAAOS,GAAG,CAACF;IACzB,IAAI,CAACJ,OAAO,OAAO;IACnB,IAAIY;IACJ,IAAI;QACFA,OAAOZ,MAAMQ,SAAS;IACxB,EAAE,OAAOK,OAAO;QACdC,QAAQD,KAAK,CAAC,CAAC,UAAU,EAAEb,MAAMC,QAAQ,CAAC,sBAAsB,EAAEG,QAAQ,EAAES;QAC5E,OAAO;IACT;IACA,MAAME,QAAQC,OAAOJ,eAAAA,OAAQ,IAAIV,IAAI;IACrC,IAAI,CAAC,gBAAgBe,IAAI,CAACF,QAAQ,OAAO;IACzC,IAAI,CAAC,gBAAgBE,IAAI,CAACN,QAAQ,OAAO;IACzC,0EAA0E;IAC1E,sEAAsE;IACtE,4EAA4E;IAC5E,OAAOA,SAASI;AAClB;AAEA;;;;;;;CAOC,GACD,OAAO,eAAeG,0BACpBd,MAAc,EACde,OAAsC;IAEtC,MAAMnB,QAAQH,OAAOS,GAAG,CAACF;IACzB,IAAI,EAACJ,yBAAAA,MAAOS,UAAU,GAAE,OAAO;IAC/B,IAAI,CAACC,uBAAuBN,QAAQe,QAAQR,KAAK,GAAG,OAAO;IAC3D,IAAI;QACF,MAAMX,MAAMS,UAAU,CAACU;QACvB,OAAO;IACT,EAAE,OAAON,OAAO;QACdC,QAAQD,KAAK,CACX,CAAC,UAAU,EAAEb,MAAMC,QAAQ,CAAC,iBAAiB,EAAEG,OAAO,KAAK,EAAEe,QAAQC,KAAK,EAAE,EAC5EP;QAEF,OAAO;IACT;AACF;AAEA,mEAAmE,GACnE,OAAO,SAASQ,uBAAuBjB,MAAc;;QAC5CP;IAAP,gBAAOA,cAAAA,OAAOS,GAAG,CAACF,4BAAXP,YAAoBI,QAAQ,mBAAI;AACzC;AAEA,mCAAmC,GACnC,OAAO,SAASqB;IACdzB,OAAO0B,KAAK;AACd"}