@aglyn/plugins-commerce 1.0.0-beta.284 → 1.0.0-beta.287

package/src/lib/model/pos-cellular.js

@@ -0,0 +1,293 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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.
+ */ import { STRIPE_PROCESSOR_FEE_FIXED_USD, STRIPE_PROCESSOR_FEE_PCT } from "@aglyn/aglyn/app-utils/plan-entitlements";
+/*==========================================
+ * 4G FOR STRIPE READER S710s (AGL-4038).
+ *
+ * Stripe sells cellular service for the Stripe Reader S710 as a monthly
+ * subscription per reader, billed to the Stripe account the reader is
+ * registered to — which, for every reader a store sets up here, is the
+ * PLATFORM's. A reader has it when the Terminal Location it is registered
+ * to has a Configuration with `cellular[enabled]`; Stripe bills a reader for
+ * every calendar month it had it at any time.
+ *
+ * So 4G is turned on for a STORE: the platform keeps one Location and one
+ * Configuration per store (`pos-terminal.ts`), and the native apps' connection
+ * tokens are scoped to that one Location, so a second, cellular Location for
+ * some of a store's readers would be one those apps could never reach, and
+ * moving a reader there takes a fresh pairing code. Every S710 at a store
+ * with 4G on has it, and each one is charged.
+ *
+ * The store's workspace pays what the platform pays, passed through: per
+ * S710 per calendar month, Stripe's cellular price, plus what collecting it
+ * costs the platform (the card processing on the charge), with no markup.
+ * Both are configuration, never literals here:
+ *
+ *   POS_CELLULAR_MONTHLY_COST_CENTS        Stripe's price per reader per
+ *                                          month, in cents. Unset: 4G is not
+ *                                          offered anywhere (hidden, not
+ *                                          disabled).
+ *   POS_CELLULAR_BILLING_COST_BPS          the processing percentage on the
+ *                                          charge, in basis points (default:
+ *                                          the platform's card rate)
+ *   POS_CELLULAR_BILLING_COST_FIXED_CENTS  the processing fixed fee per
+ *                                          charge (default: the platform's)
+ *   STRIPE_PRODUCT_POS_CELLULAR            the product the invoice line is
+ *                                          billed against (its tax code);
+ *                                          `setup-stripe.mjs` makes it
+ *   POS_CELLULAR_GRACE_DAYS                how long a month's charge may stay
+ *                                          unpaid before 4G is turned off for
+ *                                          the workspace's stores (default 14)
+ *
+ * Billed in ARREARS, once per workspace per calendar month, on a one-off
+ * invoice through core's usage-invoice charge — the same path a domain or
+ * an AI overage takes — for the readers that had 4G at any time that month,
+ * which is what Stripe bills the platform for. Turning 4G off stops the
+ * charge from the next calendar month.
+ *
+ * A charge that does not collect stays open on the workspace's Billing page
+ * and staff are alerted; the people who manage its billing are warned the
+ * same day, once, of the day 4G turns off unless it is paid. Still unpaid
+ * after the grace period, 4G is turned off at Stripe for every store of the
+ * workspace, and they are told again; paying does not turn it back on, and
+ * it cannot be turned on again until the charge is paid. A workspace deleted
+ * mid-month is charged for that final month as it is erased.
+ *=========================================*/ export const POS_CELLULAR_ENV = {
+    monthlyCostCents: 'POS_CELLULAR_MONTHLY_COST_CENTS',
+    billingCostBps: 'POS_CELLULAR_BILLING_COST_BPS',
+    billingCostFixedCents: 'POS_CELLULAR_BILLING_COST_FIXED_CENTS',
+    productId: 'STRIPE_PRODUCT_POS_CELLULAR',
+    graceDays: 'POS_CELLULAR_GRACE_DAYS'
+};
+/** How long a month's charge may stay unpaid before 4G is turned off, unless configured. */ export const POS_CELLULAR_DEFAULT_GRACE_DAYS = 14;
+/** A day, in milliseconds. */ export const POS_CELLULAR_DAY_MS = 24 * 60 * 60 * 1000;
+/** The platform's card processing rate, in basis points: the default billing cost. */ export const POS_CELLULAR_DEFAULT_BILLING_COST_BPS = Math.round(STRIPE_PROCESSOR_FEE_PCT * 10000);
+/** The platform's card processing fixed fee, in cents: the default billing cost. */ export const POS_CELLULAR_DEFAULT_BILLING_COST_FIXED_CENTS = Math.round(STRIPE_PROCESSOR_FEE_FIXED_USD * 100);
+/** The Stripe device types that take cellular service: the S710, and its simulator. */ export const POS_CELLULAR_DEVICE_TYPES = [
+    'stripe_s710',
+    'simulated_stripe_s710'
+];
+/** The top-level, server-only record of each reader's 4G months. */ export const POS_CELLULAR_READERS_COLLECTION = 'posCellularReaders';
+/** The top-level, server-only record of each workspace's monthly 4G charge. */ export const POS_CELLULAR_CHARGES_COLLECTION = 'posCellularCharges';
+/** The metadata `kind` the charge's invoice carries. */ export const POS_CELLULAR_CHARGE_KIND = 'pos-cellular';
+/** How many 4G periods a reader's record keeps: two years of on and off. */ export const POS_CELLULAR_MAX_PERIODS = 24;
+function wholeNumber(text, fallback, max) {
+    const trimmed = String(text != null ? text : '').trim();
+    if (!trimmed) return fallback;
+    if (!/^\d+$/.test(trimmed)) return null;
+    const value = Number(trimmed);
+    return Number.isSafeInteger(value) && value <= max ? value : null;
+}
+/**
+ * The deployment's 4G pricing, or null when 4G is not offered: no monthly
+ * cost, no product, or a value that is not a whole number in range. A bad
+ * value hides the feature rather than billing a guess.
+ */ export function parsePosCellularConfig(env = process.env) {
+    var _env_POS_CELLULAR_ENV_monthlyCostCents, _env_POS_CELLULAR_ENV_productId;
+    const costText = String((_env_POS_CELLULAR_ENV_monthlyCostCents = env[POS_CELLULAR_ENV.monthlyCostCents]) != null ? _env_POS_CELLULAR_ENV_monthlyCostCents : '').trim();
+    if (!/^\d+$/.test(costText)) return null;
+    const monthlyCostCents = Number(costText);
+    if (!Number.isSafeInteger(monthlyCostCents) || monthlyCostCents <= 0 || monthlyCostCents > 100000) return null;
+    const productId = String((_env_POS_CELLULAR_ENV_productId = env[POS_CELLULAR_ENV.productId]) != null ? _env_POS_CELLULAR_ENV_productId : '').trim();
+    if (!/^prod_[A-Za-z0-9]+$/.test(productId)) return null;
+    const billingCostBps = wholeNumber(env[POS_CELLULAR_ENV.billingCostBps], POS_CELLULAR_DEFAULT_BILLING_COST_BPS, 5000);
+    const billingCostFixedCents = wholeNumber(env[POS_CELLULAR_ENV.billingCostFixedCents], POS_CELLULAR_DEFAULT_BILLING_COST_FIXED_CENTS, 1000);
+    const graceDays = wholeNumber(env[POS_CELLULAR_ENV.graceDays], POS_CELLULAR_DEFAULT_GRACE_DAYS, 90);
+    if (billingCostBps === null || billingCostFixedCents === null || graceDays === null || graceDays < 1) return null;
+    return {
+        monthlyCostCents,
+        billingCostBps,
+        billingCostFixedCents,
+        productId,
+        graceDays
+    };
+}
+/**
+ * One workspace's 4G charge for a month, in whole cents: Stripe's price for
+ * each reader, grossed up so that what the charge's own processing takes
+ * leaves the platform exactly that:
+ *
+ *     ceil((readers × cost + fixed) / (1 − rate))
+ *
+ * Rounded up, the one direction that never bills below cost.
+ * Zero readers is no charge.
+ */ export function posCellularChargeCents(readers, config) {
+    if (!Number.isSafeInteger(readers) || readers <= 0) return 0;
+    const passThrough = readers * config.monthlyCostCents + config.billingCostFixedCents;
+    return Math.ceil(passThrough * 10000 / (10000 - config.billingCostBps));
+}
+/**
+ * What one reader costs a month, as the console shows it: a store's charge
+ * for a single reader. More readers on one charge share its fixed fee, so
+ * this is never less than any reader's share of a larger charge.
+ */ export function posCellularReaderMonthlyCents(config) {
+    return posCellularChargeCents(1, config);
+}
+/** Whether a reader of this Stripe device type can have 4G. */ export function isPosCellularDeviceType(deviceType) {
+    return typeof deviceType === 'string' && POS_CELLULAR_DEVICE_TYPES.includes(deviceType);
+}
+/** `2026-10` for a time in October 2026, in UTC. */ export function posCellularMonthKey(ms) {
+    const date = new Date(ms);
+    return `${date.getUTCFullYear()}-${String(date.getUTCMonth() + 1).padStart(2, '0')}`;
+}
+/** The calendar month before the one `ms` falls in. */ export function posCellularPreviousMonthKey(ms) {
+    const date = new Date(ms);
+    return posCellularMonthKey(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() - 1, 1));
+}
+/** A month's first instant, and the next month's, in UTC; null for a key that is not one. */ export function posCellularMonthBounds(month) {
+    const match = /^(\d{4})-(\d{2})$/.exec(month);
+    if (!match) return null;
+    const year = Number(match[1]);
+    const index = Number(match[2]) - 1;
+    if (index < 0 || index > 11) return null;
+    return {
+        startMs: Date.UTC(year, index, 1),
+        endMs: Date.UTC(year, index + 1, 1)
+    };
+}
+/** `October 2026`, for the invoice line. */ export function posCellularMonthLabel(month) {
+    const bounds = posCellularMonthBounds(month);
+    if (!bounds) return month;
+    return new Date(bounds.startMs).toLocaleString('en-US', {
+        month: 'long',
+        year: 'numeric',
+        timeZone: 'UTC'
+    });
+}
+/** The record's document id. */ export function posCellularReaderId(hostId, readerId) {
+    return `${hostId}_${readerId}`;
+}
+/** The record with a period open from `now`, unless one already is. */ export function openPosCellularPeriod(base, existing, now) {
+    var _ref, _ref1;
+    const periods = (_ref = existing == null ? void 0 : existing.periods) != null ? _ref : [];
+    const open = periods.some((period)=>period.toMs === null);
+    return _extends({}, base, {
+        enabled: true,
+        periods: open ? periods : [
+            ...periods,
+            {
+                fromMs: now,
+                toMs: null
+            }
+        ].slice(-POS_CELLULAR_MAX_PERIODS),
+        disabledAtMs: (_ref1 = existing == null ? void 0 : existing.disabledAtMs) != null ? _ref1 : null,
+        updatedAtMs: now
+    });
+}
+/** The record with its open period closed at `now`; unchanged when none is open. */ export function closePosCellularPeriod(existing, now) {
+    if (!existing.periods.some((period)=>period.toMs === null) && !existing.enabled) return existing;
+    return _extends({}, existing, {
+        enabled: false,
+        periods: existing.periods.map((period)=>period.toMs === null ? _extends({}, period, {
+                toMs: now
+            }) : period),
+        disabledAtMs: now,
+        updatedAtMs: now
+    });
+}
+/** Whether a reader had 4G at any time in the month. */ export function posCellularBilledInMonth(record, bounds) {
+    var _record_periods;
+    return ((_record_periods = record.periods) != null ? _record_periods : []).some((period)=>period.fromMs < bounds.endMs && (period.toMs === null || period.toMs > bounds.startMs));
+}
+/** Each workspace's readers that had 4G in the month, by workspace. */ export function posCellularReadersByWorkspace(records, month) {
+    const bounds = posCellularMonthBounds(month);
+    const byOrg = new Map();
+    if (!bounds) return byOrg;
+    for (const record of records){
+        var _byOrg_get;
+        if (!record.orgId || !posCellularBilledInMonth(record, bounds)) continue;
+        const entry = (_byOrg_get = byOrg.get(record.orgId)) != null ? _byOrg_get : {
+            readers: 0,
+            hostIds: []
+        };
+        entry.readers += 1;
+        if (!entry.hostIds.includes(record.hostId)) entry.hostIds.push(record.hostId);
+        byOrg.set(record.orgId, entry);
+    }
+    return byOrg;
+}
+/** States a later run never charges again. */ export const POS_CELLULAR_SETTLED_STATES = [
+    'paid',
+    'open',
+    'suspended',
+    'voided',
+    'no-workspace',
+    'no-customer',
+    'below-minimum'
+];
+/**
+ * When a charge left open runs out of grace: the grace period after it was
+ * left open (or, for a charge from before that was recorded, after it last
+ * changed).
+ */ export function posCellularGraceEndsAtMs(charge, graceDays) {
+    var _charge_openedAtMs;
+    return Number((_charge_openedAtMs = charge.openedAtMs) != null ? _charge_openedAtMs : charge.updatedAtMs) + graceDays * POS_CELLULAR_DAY_MS;
+}
+/** Whether an open charge is past its grace period. */ export function posCellularOverdue(charge, graceDays, now) {
+    return charge.state === 'open' && now >= posCellularGraceEndsAtMs(charge, graceDays);
+}
+/**
+ * Whether the people who manage a workspace's billing are still owed the
+ * warning that 4G turns off unless the charge is paid: an open charge not yet
+ * warned of. Never a charge made as the workspace was erased, whose 4G is
+ * already off and whose members are gone.
+ */ export function posCellularWarningDue(charge) {
+    return charge.state === 'open' && !charge.warnedAtMs && !charge.final;
+}
+/**
+ * A day as the workspace reads it, `November 16, 2026`, in its time zone
+ * (UTC for a zone the runtime cannot format in).
+ */ export function posCellularDayLabel(ms, timeZone = 'UTC') {
+    const options = {
+        month: 'long',
+        day: 'numeric',
+        year: 'numeric'
+    };
+    try {
+        return new Date(ms).toLocaleDateString('en-US', _extends({}, options, {
+            timeZone
+        }));
+    } catch (unused) {
+        return new Date(ms).toLocaleDateString('en-US', _extends({}, options, {
+            timeZone: 'UTC'
+        }));
+    }
+}
+/**
+ * The 4G row of a store's POS devices card: shown only where 4G is offered
+ * and the store has an S710, or already has 4G on (so it can be turned off).
+ */ export function posCellularView(config, terminal, readers, options = {}) {
+    var _suspension_atMs, _options_turnOnBlocked;
+    if (!config) return null;
+    const enabled = (terminal == null ? void 0 : terminal.cellularEnabled) === true;
+    const capable = readers.filter((reader)=>isPosCellularDeviceType(reader.deviceType)).length;
+    if (!enabled && capable === 0) return null;
+    const suspension = terminal == null ? void 0 : terminal.cellularSuspended;
+    const suspended = !enabled && suspension && typeof suspension.month === 'string' ? {
+        month: posCellularMonthLabel(suspension.month),
+        atMs: Number((_suspension_atMs = suspension.atMs) != null ? _suspension_atMs : 0)
+    } : null;
+    return {
+        readerMonthlyCents: posCellularReaderMonthlyCents(config),
+        enabled,
+        readers: capable,
+        suspended,
+        turnOnBlocked: (_options_turnOnBlocked = options.turnOnBlocked) != null ? _options_turnOnBlocked : null
+    };
+}
+
+//# sourceMappingURL=pos-cellular.js.map

package/src/lib/model/pos-cellular.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/pos-cellular.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\nimport {\n  STRIPE_PROCESSOR_FEE_FIXED_USD,\n  STRIPE_PROCESSOR_FEE_PCT,\n} from '@aglyn/aglyn/app-utils/plan-entitlements'\n\n/*==========================================\n * 4G FOR STRIPE READER S710s (AGL-4038).\n *\n * Stripe sells cellular service for the Stripe Reader S710 as a monthly\n * subscription per reader, billed to the Stripe account the reader is\n * registered to — which, for every reader a store sets up here, is the\n * PLATFORM's. A reader has it when the Terminal Location it is registered\n * to has a Configuration with `cellular[enabled]`; Stripe bills a reader for\n * every calendar month it had it at any time.\n *\n * So 4G is turned on for a STORE: the platform keeps one Location and one\n * Configuration per store (`pos-terminal.ts`), and the native apps' connection\n * tokens are scoped to that one Location, so a second, cellular Location for\n * some of a store's readers would be one those apps could never reach, and\n * moving a reader there takes a fresh pairing code. Every S710 at a store\n * with 4G on has it, and each one is charged.\n *\n * The store's workspace pays what the platform pays, passed through: per\n * S710 per calendar month, Stripe's cellular price, plus what collecting it\n * costs the platform (the card processing on the charge), with no markup.\n * Both are configuration, never literals here:\n *\n *   POS_CELLULAR_MONTHLY_COST_CENTS        Stripe's price per reader per\n *                                          month, in cents. Unset: 4G is not\n *                                          offered anywhere (hidden, not\n *                                          disabled).\n *   POS_CELLULAR_BILLING_COST_BPS          the processing percentage on the\n *                                          charge, in basis points (default:\n *                                          the platform's card rate)\n *   POS_CELLULAR_BILLING_COST_FIXED_CENTS  the processing fixed fee per\n *                                          charge (default: the platform's)\n *   STRIPE_PRODUCT_POS_CELLULAR            the product the invoice line is\n *                                          billed against (its tax code);\n *                                          `setup-stripe.mjs` makes it\n *   POS_CELLULAR_GRACE_DAYS                how long a month's charge may stay\n *                                          unpaid before 4G is turned off for\n *                                          the workspace's stores (default 14)\n *\n * Billed in ARREARS, once per workspace per calendar month, on a one-off\n * invoice through core's usage-invoice charge — the same path a domain or\n * an AI overage takes — for the readers that had 4G at any time that month,\n * which is what Stripe bills the platform for. Turning 4G off stops the\n * charge from the next calendar month.\n *\n * A charge that does not collect stays open on the workspace's Billing page\n * and staff are alerted; the people who manage its billing are warned the\n * same day, once, of the day 4G turns off unless it is paid. Still unpaid\n * after the grace period, 4G is turned off at Stripe for every store of the\n * workspace, and they are told again; paying does not turn it back on, and\n * it cannot be turned on again until the charge is paid. A workspace deleted\n * mid-month is charged for that final month as it is erased.\n *=========================================*/\n\nexport const POS_CELLULAR_ENV = {\n  monthlyCostCents: 'POS_CELLULAR_MONTHLY_COST_CENTS',\n  billingCostBps: 'POS_CELLULAR_BILLING_COST_BPS',\n  billingCostFixedCents: 'POS_CELLULAR_BILLING_COST_FIXED_CENTS',\n  productId: 'STRIPE_PRODUCT_POS_CELLULAR',\n  graceDays: 'POS_CELLULAR_GRACE_DAYS',\n} as const\n\n/** How long a month's charge may stay unpaid before 4G is turned off, unless configured. */\nexport const POS_CELLULAR_DEFAULT_GRACE_DAYS = 14\n\n/** A day, in milliseconds. */\nexport const POS_CELLULAR_DAY_MS = 24 * 60 * 60 * 1000\n\n/** The platform's card processing rate, in basis points: the default billing cost. */\nexport const POS_CELLULAR_DEFAULT_BILLING_COST_BPS = Math.round(STRIPE_PROCESSOR_FEE_PCT * 10_000)\n\n/** The platform's card processing fixed fee, in cents: the default billing cost. */\nexport const POS_CELLULAR_DEFAULT_BILLING_COST_FIXED_CENTS = Math.round(STRIPE_PROCESSOR_FEE_FIXED_USD * 100)\n\n/** The Stripe device types that take cellular service: the S710, and its simulator. */\nexport const POS_CELLULAR_DEVICE_TYPES: readonly string[] = ['stripe_s710', 'simulated_stripe_s710']\n\n/** The top-level, server-only record of each reader's 4G months. */\nexport const POS_CELLULAR_READERS_COLLECTION = 'posCellularReaders'\n\n/** The top-level, server-only record of each workspace's monthly 4G charge. */\nexport const POS_CELLULAR_CHARGES_COLLECTION = 'posCellularCharges'\n\n/** The metadata `kind` the charge's invoice carries. */\nexport const POS_CELLULAR_CHARGE_KIND = 'pos-cellular'\n\n/** How many 4G periods a reader's record keeps: two years of on and off. */\nexport const POS_CELLULAR_MAX_PERIODS = 24\n\nexport interface PosCellularConfig {\n  monthlyCostCents: number\n  billingCostBps: number\n  billingCostFixedCents: number\n  productId: string\n  /** Days a charge may stay unpaid before 4G is turned off for the workspace. */\n  graceDays: number\n}\n\nfunction wholeNumber(text: string | undefined, fallback: number, max: number): number | null {\n  const trimmed = String(text ?? '').trim()\n  if (!trimmed) return fallback\n  if (!/^\\d+$/.test(trimmed)) return null\n  const value = Number(trimmed)\n  return Number.isSafeInteger(value) && value <= max ? value : null\n}\n\n/**\n * The deployment's 4G pricing, or null when 4G is not offered: no monthly\n * cost, no product, or a value that is not a whole number in range. A bad\n * value hides the feature rather than billing a guess.\n */\nexport function parsePosCellularConfig(\n  env: Record<string, string | undefined> = process.env,\n): PosCellularConfig | null {\n  const costText = String(env[POS_CELLULAR_ENV.monthlyCostCents] ?? '').trim()\n  if (!/^\\d+$/.test(costText)) return null\n  const monthlyCostCents = Number(costText)\n  if (!Number.isSafeInteger(monthlyCostCents) || monthlyCostCents <= 0 || monthlyCostCents > 100_000) return null\n  const productId = String(env[POS_CELLULAR_ENV.productId] ?? '').trim()\n  if (!/^prod_[A-Za-z0-9]+$/.test(productId)) return null\n  const billingCostBps = wholeNumber(env[POS_CELLULAR_ENV.billingCostBps], POS_CELLULAR_DEFAULT_BILLING_COST_BPS, 5_000)\n  const billingCostFixedCents = wholeNumber(\n    env[POS_CELLULAR_ENV.billingCostFixedCents],\n    POS_CELLULAR_DEFAULT_BILLING_COST_FIXED_CENTS,\n    1_000,\n  )\n  const graceDays = wholeNumber(env[POS_CELLULAR_ENV.graceDays], POS_CELLULAR_DEFAULT_GRACE_DAYS, 90)\n  if (billingCostBps === null || billingCostFixedCents === null || graceDays === null || graceDays < 1) return null\n  return { monthlyCostCents, billingCostBps, billingCostFixedCents, productId, graceDays }\n}\n\n/**\n * One workspace's 4G charge for a month, in whole cents: Stripe's price for\n * each reader, grossed up so that what the charge's own processing takes\n * leaves the platform exactly that:\n *\n *     ceil((readers × cost + fixed) / (1 − rate))\n *\n * Rounded up, the one direction that never bills below cost.\n * Zero readers is no charge.\n */\nexport function posCellularChargeCents(readers: number, config: PosCellularConfig): number {\n  if (!Number.isSafeInteger(readers) || readers <= 0) return 0\n  const passThrough = readers * config.monthlyCostCents + config.billingCostFixedCents\n  return Math.ceil((passThrough * 10_000) / (10_000 - config.billingCostBps))\n}\n\n/**\n * What one reader costs a month, as the console shows it: a store's charge\n * for a single reader. More readers on one charge share its fixed fee, so\n * this is never less than any reader's share of a larger charge.\n */\nexport function posCellularReaderMonthlyCents(config: PosCellularConfig): number {\n  return posCellularChargeCents(1, config)\n}\n\n/** Whether a reader of this Stripe device type can have 4G. */\nexport function isPosCellularDeviceType(deviceType: unknown): boolean {\n  return typeof deviceType === 'string' && POS_CELLULAR_DEVICE_TYPES.includes(deviceType)\n}\n\n/** `2026-10` for a time in October 2026, in UTC. */\nexport function posCellularMonthKey(ms: number): string {\n  const date = new Date(ms)\n  return `${date.getUTCFullYear()}-${String(date.getUTCMonth() + 1).padStart(2, '0')}`\n}\n\n/** The calendar month before the one `ms` falls in. */\nexport function posCellularPreviousMonthKey(ms: number): string {\n  const date = new Date(ms)\n  return posCellularMonthKey(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() - 1, 1))\n}\n\n/** A month's first instant, and the next month's, in UTC; null for a key that is not one. */\nexport function posCellularMonthBounds(month: string): { startMs: number; endMs: number } | null {\n  const match = /^(\\d{4})-(\\d{2})$/.exec(month)\n  if (!match) return null\n  const year = Number(match[1])\n  const index = Number(match[2]) - 1\n  if (index < 0 || index > 11) return null\n  return { startMs: Date.UTC(year, index, 1), endMs: Date.UTC(year, index + 1, 1) }\n}\n\n/** `October 2026`, for the invoice line. */\nexport function posCellularMonthLabel(month: string): string {\n  const bounds = posCellularMonthBounds(month)\n  if (!bounds) return month\n  return new Date(bounds.startMs).toLocaleString('en-US', { month: 'long', year: 'numeric', timeZone: 'UTC' })\n}\n\n/** One stretch of time a reader had 4G: from when it was turned on, to when it was turned off (open while it is on). */\nexport interface PosCellularPeriod {\n  fromMs: number\n  toMs: number | null\n}\n\n/**\n * `posCellularReaders/{hostId}_{readerId}`: one S710's 4G months, written\n * only by the server. No person is named on it: a workspace, a store, a\n * Stripe reader and its serial, and when it had 4G.\n */\nexport interface PosCellularReaderRecord {\n  orgId: string\n  hostId: string\n  readerId: string\n  serialNumber: string | null\n  /** The store's Terminal Configuration that carries `cellular[enabled]`. */\n  stripeConfigurationId: string | null\n  enabled: boolean\n  periods: PosCellularPeriod[]\n  /** The last time a period was closed, which the month's charge queries by. */\n  disabledAtMs: number | null\n  updatedAtMs: number\n}\n\n/** The record's document id. */\nexport function posCellularReaderId(hostId: string, readerId: string): string {\n  return `${hostId}_${readerId}`\n}\n\n/** The record with a period open from `now`, unless one already is. */\nexport function openPosCellularPeriod(\n  base: Omit<PosCellularReaderRecord, 'enabled' | 'periods' | 'disabledAtMs' | 'updatedAtMs'>,\n  existing: PosCellularReaderRecord | null,\n  now: number,\n): PosCellularReaderRecord {\n  const periods = existing?.periods ?? []\n  const open = periods.some((period) => period.toMs === null)\n  return {\n    ...base,\n    enabled: true,\n    periods: open ? periods : [...periods, { fromMs: now, toMs: null }].slice(-POS_CELLULAR_MAX_PERIODS),\n    disabledAtMs: existing?.disabledAtMs ?? null,\n    updatedAtMs: now,\n  }\n}\n\n/** The record with its open period closed at `now`; unchanged when none is open. */\nexport function closePosCellularPeriod(existing: PosCellularReaderRecord, now: number): PosCellularReaderRecord {\n  if (!existing.periods.some((period) => period.toMs === null) && !existing.enabled) return existing\n  return {\n    ...existing,\n    enabled: false,\n    periods: existing.periods.map((period) => (period.toMs === null ? { ...period, toMs: now } : period)),\n    disabledAtMs: now,\n    updatedAtMs: now,\n  }\n}\n\n/** Whether a reader had 4G at any time in the month. */\nexport function posCellularBilledInMonth(\n  record: Pick<PosCellularReaderRecord, 'periods'>,\n  bounds: { startMs: number; endMs: number },\n): boolean {\n  return (record.periods ?? []).some(\n    (period) => period.fromMs < bounds.endMs && (period.toMs === null || period.toMs > bounds.startMs),\n  )\n}\n\n/** Each workspace's readers that had 4G in the month, by workspace. */\nexport function posCellularReadersByWorkspace(\n  records: ReadonlyArray<PosCellularReaderRecord>,\n  month: string,\n): Map<string, { readers: number; hostIds: string[] }> {\n  const bounds = posCellularMonthBounds(month)\n  const byOrg = new Map<string, { readers: number; hostIds: string[] }>()\n  if (!bounds) return byOrg\n  for (const record of records) {\n    if (!record.orgId || !posCellularBilledInMonth(record, bounds)) continue\n    const entry = byOrg.get(record.orgId) ?? { readers: 0, hostIds: [] }\n    entry.readers += 1\n    if (!entry.hostIds.includes(record.hostId)) entry.hostIds.push(record.hostId)\n    byOrg.set(record.orgId, entry)\n  }\n  return byOrg\n}\n\n/**\n * The outcome of a workspace's month: charged and paid; charged and left\n * open on their Billing page because the card failed; still unpaid after the\n * grace period, so 4G was turned off for the workspace (`suspended`); its\n * invoice voided by staff (`voided`); not charged because there is no one to\n * bill (no workspace, no customer) or nothing to bill (under Stripe's\n * minimum); or `charging`, claimed by a run in progress.\n */\nexport type PosCellularChargeState =\n  | 'charging'\n  | 'paid'\n  | 'open'\n  | 'suspended'\n  | 'voided'\n  | 'failed'\n  | 'no-workspace'\n  | 'no-customer'\n  | 'below-minimum'\n\n/** States a later run never charges again. */\nexport const POS_CELLULAR_SETTLED_STATES: readonly PosCellularChargeState[] = [\n  'paid',\n  'open',\n  'suspended',\n  'voided',\n  'no-workspace',\n  'no-customer',\n  'below-minimum',\n]\n\n/** `posCellularCharges/{orgId}_{month}`: one workspace's 4G charge for one month. */\nexport interface PosCellularCharge {\n  orgId: string\n  month: string\n  readers: number\n  amountCents: number\n  state: PosCellularChargeState\n  invoiceId: string | null\n  paidCents: number\n  attempts: number\n  createdAtMs: number\n  updatedAtMs: number\n  /** When the charge was left open, which the grace period counts from. */\n  openedAtMs?: number | null\n  /** When 4G was turned off for the workspace because it stayed unpaid. */\n  suspendedAtMs?: number | null\n  /** The stores 4G was turned off for, whose notice clears once it is paid. */\n  suspendedHostIds?: string[]\n  /**\n   * When the people who manage the workspace's billing were warned, as the\n   * charge was left open, of the day 4G turns off unless it is paid.\n   */\n  warnedAtMs?: number | null\n  /** When the people who manage the workspace's billing were told 4G was turned off. */\n  noticeSentAtMs?: number | null\n  /** Charged as the workspace was erased, for the month it was deleted in (or the one before). */\n  final?: boolean\n}\n\n/**\n * When a charge left open runs out of grace: the grace period after it was\n * left open (or, for a charge from before that was recorded, after it last\n * changed).\n */\nexport function posCellularGraceEndsAtMs(\n  charge: Pick<PosCellularCharge, 'openedAtMs' | 'updatedAtMs'>,\n  graceDays: number,\n): number {\n  return Number(charge.openedAtMs ?? charge.updatedAtMs) + graceDays * POS_CELLULAR_DAY_MS\n}\n\n/** Whether an open charge is past its grace period. */\nexport function posCellularOverdue(\n  charge: Pick<PosCellularCharge, 'state' | 'openedAtMs' | 'updatedAtMs'>,\n  graceDays: number,\n  now: number,\n): boolean {\n  return charge.state === 'open' && now >= posCellularGraceEndsAtMs(charge, graceDays)\n}\n\n/**\n * Whether the people who manage a workspace's billing are still owed the\n * warning that 4G turns off unless the charge is paid: an open charge not yet\n * warned of. Never a charge made as the workspace was erased, whose 4G is\n * already off and whose members are gone.\n */\nexport function posCellularWarningDue(\n  charge: Pick<PosCellularCharge, 'state' | 'warnedAtMs' | 'final'>,\n): boolean {\n  return charge.state === 'open' && !charge.warnedAtMs && !charge.final\n}\n\n/**\n * A day as the workspace reads it, `November 16, 2026`, in its time zone\n * (UTC for a zone the runtime cannot format in).\n */\nexport function posCellularDayLabel(ms: number, timeZone = 'UTC'): string {\n  const options = { month: 'long', day: 'numeric', year: 'numeric' } as const\n  try {\n    return new Date(ms).toLocaleDateString('en-US', { ...options, timeZone })\n  } catch {\n    return new Date(ms).toLocaleDateString('en-US', { ...options, timeZone: 'UTC' })\n  }\n}\n\n/**\n * On a store's terminal settings (`cellularSuspended`) while 4G is off because\n * a month's charge was not paid: which month, its invoice, and when.\n */\nexport interface PosCellularSuspension {\n  month: string\n  invoiceId: string | null\n  atMs: number\n}\n\n/** What the POS devices card is told about 4G for a store; null hides it. */\nexport interface PosCellularView {\n  /** What one reader costs a month, in cents, before any sales tax. */\n  readerMonthlyCents: number\n  enabled: boolean\n  /** The store's readers that take 4G. */\n  readers: number\n  /** Turned off because a month's charge was not paid: that month, as `October 2026`, and when. */\n  suspended?: { month: string; atMs: number } | null\n  /**\n   * Why the viewer may not turn 4G ON (it is charged to the workspace, so it\n   * also takes \"Manage billing\"), or null. Turning it off needs only the\n   * card's own key.\n   */\n  turnOnBlocked?: string | null\n}\n\n/**\n * The 4G row of a store's POS devices card: shown only where 4G is offered\n * and the store has an S710, or already has 4G on (so it can be turned off).\n */\nexport function posCellularView(\n  config: PosCellularConfig | null,\n  terminal: { cellularEnabled?: unknown; cellularSuspended?: unknown } | null | undefined,\n  readers: ReadonlyArray<{ deviceType?: unknown }>,\n  options: { turnOnBlocked?: string | null } = {},\n): PosCellularView | null {\n  if (!config) return null\n  const enabled = terminal?.cellularEnabled === true\n  const capable = readers.filter((reader) => isPosCellularDeviceType(reader.deviceType)).length\n  if (!enabled && capable === 0) return null\n  const suspension = terminal?.cellularSuspended as Partial<PosCellularSuspension> | null | undefined\n  const suspended =\n    !enabled && suspension && typeof suspension.month === 'string'\n      ? { month: posCellularMonthLabel(suspension.month), atMs: Number(suspension.atMs ?? 0) }\n      : null\n  return {\n    readerMonthlyCents: posCellularReaderMonthlyCents(config),\n    enabled,\n    readers: capable,\n    suspended,\n    turnOnBlocked: options.turnOnBlocked ?? null,\n  }\n}\n"],"names":["STRIPE_PROCESSOR_FEE_FIXED_USD","STRIPE_PROCESSOR_FEE_PCT","POS_CELLULAR_ENV","monthlyCostCents","billingCostBps","billingCostFixedCents","productId","graceDays","POS_CELLULAR_DEFAULT_GRACE_DAYS","POS_CELLULAR_DAY_MS","POS_CELLULAR_DEFAULT_BILLING_COST_BPS","Math","round","POS_CELLULAR_DEFAULT_BILLING_COST_FIXED_CENTS","POS_CELLULAR_DEVICE_TYPES","POS_CELLULAR_READERS_COLLECTION","POS_CELLULAR_CHARGES_COLLECTION","POS_CELLULAR_CHARGE_KIND","POS_CELLULAR_MAX_PERIODS","wholeNumber","text","fallback","max","trimmed","String","trim","test","value","Number","isSafeInteger","parsePosCellularConfig","env","process","costText","posCellularChargeCents","readers","config","passThrough","ceil","posCellularReaderMonthlyCents","isPosCellularDeviceType","deviceType","includes","posCellularMonthKey","ms","date","Date","getUTCFullYear","getUTCMonth","padStart","posCellularPreviousMonthKey","UTC","posCellularMonthBounds","month","match","exec","year","index","startMs","endMs","posCellularMonthLabel","bounds","toLocaleString","timeZone","posCellularReaderId","hostId","readerId","openPosCellularPeriod","base","existing","now","periods","open","some","period","toMs","enabled","fromMs","slice","disabledAtMs","updatedAtMs","closePosCellularPeriod","map","posCellularBilledInMonth","record","posCellularReadersByWorkspace","records","byOrg","Map","orgId","entry","get","hostIds","push","set","POS_CELLULAR_SETTLED_STATES","posCellularGraceEndsAtMs","charge","openedAtMs","posCellularOverdue","state","posCellularWarningDue","warnedAtMs","final","posCellularDayLabel","options","day","toLocaleDateString","posCellularView","terminal","suspension","cellularEnabled","capable","filter","reader","length","cellularSuspended","suspended","atMs","readerMonthlyCents","turnOnBlocked"],"mappings":"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"}

package/src/lib/model/pos-hardware-in-person.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @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.
+ */
+import type { OrderHardwareBuyer } from './commerce-orders';
+import { type PosHardwareAttachment, type PosHardwareLine, type PosHardwareOrder, type PosHardwareSkuId, type PosHardwareTaxRegion, type PosHardwareUnit } from './pos-hardware';
+/** One register line, with the hardware item its product is, when it is one. */
+export interface PosHardwareRegisterLine {
+    sku: PosHardwareSkuId | null;
+    quantity: number;
+    unitAmountCents: number;
+}
+export interface PosHardwareRegisterShare {
+    lines: PosHardwareLine[];
+    /** The hardware lines at the prices rung. */
+    itemsCents: number;
+    discountCents: number;
+    /** What tax was charged on: the items less the discount. */
+    taxableCents: number;
+    taxCents: number;
+    totalCents: number;
+}
+/**
+ * The hardware's share of a register sale, or `null` when the sale sold no
+ * hardware. `discountCents` and `taxCents` are the SALE's.
+ */
+export declare function posHardwareRegisterShare(input: {
+    lines: readonly PosHardwareRegisterLine[];
+    discountCents: number;
+    taxCents: number;
+}): PosHardwareRegisterShare | null;
+/**
+ * One unit per reader sold, in line order; accessories carry no serial and
+ * have no unit. `serials` are the serial numbers taken at the sale, in the
+ * same order, already normalized; a reader with none waits for one.
+ */
+export declare function posHardwareUnits(lines: readonly PosHardwareLine[], serials?: readonly string[]): PosHardwareUnit[];
+/**
+ * Whose the order is: the workspace the register attached, or pending. A
+ * buyer with an account and a workspace is attached; one with only an
+ * account or only an address is pending until they have a workspace.
+ */
+export declare function posHardwareAttachmentOf(buyer: OrderHardwareBuyer | null | undefined): PosHardwareAttachment;
+/** The register sale, as the builder reads it. */
+export interface InPersonRegisterSale {
+    sellerHostId: string;
+    sellerOrgId: string;
+    registerOrderId: string;
+    number: number | null;
+    registerId: string | null;
+    kiosk: boolean;
+    offline: boolean;
+    share: PosHardwareRegisterShare;
+    /** When the sale was paid: the order's own stamp. */
+    paidAtMs: number;
+    /** The tenders that paid it, as its payments name them. */
+    tenders: string[];
+    paymentLinkSessionId: string | null;
+    /** The address the receipt went to, kept for staff when nobody is attached. */
+    receiptEmail: string | null;
+    buyer: OrderHardwareBuyer | null | undefined;
+    /** Serial numbers taken at the sale, normalized, in reader order. */
+    serials?: readonly string[];
+    /** Where the store taxes from: its own address's region. */
+    taxRegion: PosHardwareTaxRegion | null;
+    /** The store's rate, in percent, when it charged one. */
+    ratePct: number | null;
+    stripeAccountId: string | null;
+    livemode: boolean;
+    currency?: string;
+    /**
+     * How the buyer agreed to the terms of sale before paying (AGL-4038), from
+     * the register sale; absent, the receipt-and-sign notice at the sale.
+     */
+    termsAcceptance?: unknown;
+}
+/**
+ * The hardware order a register sale becomes. In-person hardware is handed
+ * over at the sale, so the order starts at Delivered, and moves to Set up
+ * once its readers are registered.
+ *
+ * The tax line states the base the store's rate was applied to — the
+ * hardware's share of what the register taxed — so the platform's return
+ * reads a stated base, never an inferred one.
+ */
+export declare function inPersonPosHardwareOrder(sale: InPersonRegisterSale): PosHardwareOrder;