lh-api-client 0.0.1

package/dist/orgs/index.d.ts

@@ -0,0 +1,113 @@
+import { Client } from '../client';
+/**
+ * One row from `GET /platform/orgs`. Mirrors `OrganizationService.listForOperator`
+ * return shape; additive backend fields don't require client changes here unless
+ * consumers want to surface them.
+ */
+export interface OrgListRow {
+    id: string;
+    name: string;
+    status: 'ACTIVE' | 'SUSPENDED' | 'CLOSED';
+    balance: string;
+    currency: string;
+}
+export interface ListOrgsArgs {
+    status?: 'ACTIVE' | 'SUSPENDED' | 'CLOSED';
+    nearLimit?: boolean;
+    overBudget?: boolean;
+    quietSinceDays?: number;
+    /**
+     * US-OP-13 / #359 — filter orgs that have any ACTIVE non-base sub whose
+     * `commitmentEnd` falls within the next N days. Used by
+     * `lh-ops org list --expiring-within Xd` for renewal-window discovery.
+     */
+    expiringWithinDays?: number;
+    sortBy?: 'balance-asc';
+}
+/**
+ * US-OP-9 (T2 of v0.1.7). Cross-org overview for platform operators.
+ * Filter flags pass through to the backend's `listForOperator` filter set.
+ * Query param names are kebab-case to mirror the CLI flag names.
+ */
+export declare function listOrgs(client: Client, args: ListOrgsArgs): Promise<OrgListRow[]>;
+/**
+ * One token's state on new-api as surfaced for operator triage (US-7).
+ * `maskedKey` is new-api-masked (never the full secret); `remainQuota === -1`
+ * means UnlimitedQuota (V2 tokens, where LH is the sole gatekeeper).
+ */
+export interface OrgTokenInfo {
+    tokenId: number;
+    tokenName: string;
+    maskedKey: string;
+    status: number;
+    statusText: string;
+    remainQuota: number;
+    usedQuota: number;
+    isExpired: boolean;
+    accessedTime: number;
+}
+export interface RenamedOrg {
+    id: string;
+    name: string;
+    status: string;
+}
+/** Rename a customer org's display name (operator action). */
+export declare function renameOrg(client: Client, orgId: string, name: string): Promise<RenamedOrg>;
+/**
+ * Body for `POST /platform/orgs` (ProvisionOrgDto). `planId` is an OPTIONAL
+ * paid plan id — when supplied a paid sub is seeded on top of the always-seeded
+ * base sub (ADR-017 §6). Requires the `write:orgs` scope on the token.
+ */
+export interface ProvisionOrgArgs {
+    orgName: string;
+    adminEmail: string;
+    adminName: string;
+    planId?: string;
+}
+/**
+ * Result of provisioning. The backend returns the created org plus the admin's
+ * one-time temp password and (optionally) the seeded paid subscription. Shape
+ * mirrors `OrganizationService.createOrgWithAdmin`; additive fields are
+ * pass-through.
+ */
+export interface ProvisionedOrg {
+    organization: {
+        id: string;
+        name: string;
+        status: string;
+        [k: string]: unknown;
+    };
+    [k: string]: unknown;
+}
+/**
+ * Provision a brand-new customer org + its admin user (operator action,
+ * sales-driven). Mirrors `POST /platform/orgs`. Token must carry `write:orgs`.
+ */
+export declare function provisionOrg(client: Client, args: ProvisionOrgArgs): Promise<ProvisionedOrg>;
+/**
+ * Body for `PATCH /platform/orgs/:orgId/currency` (SetOrgCurrencyDto, ADR-026).
+ * Binary: CNY requires a positive `contractRate`; USD must omit it. The rate is
+ * display/top-up only, never a billing input. Requires `write:billing`.
+ */
+export interface SetOrgCurrencyArgs {
+    currency: 'CNY' | 'USD';
+    /** Required + positive for CNY; omit for USD. Cross-field rule enforced server-side. */
+    contractRate?: number;
+}
+export interface OrgCurrency {
+    id: string;
+    currency: 'CNY' | 'USD';
+    contractRate: string | null;
+    [k: string]: unknown;
+}
+/**
+ * Set a customer org's settlement currency + fixed contract rate (ADR-026).
+ * Mirrors `PATCH /platform/orgs/:orgId/currency`. Token must carry
+ * `write:billing`.
+ */
+export declare function setOrgCurrency(client: Client, orgId: string, args: SetOrgCurrencyArgs): Promise<OrgCurrency>;
+/**
+ * US-7 read slice (#435). Pass through the org's new-api token state for
+ * "is it LH or new-api?" triage. Read-only.
+ */
+export declare function getOrgTokens(client: Client, orgId: string): Promise<OrgTokenInfo[]>;

package/dist/orgs/index.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listOrgs = listOrgs;
+exports.renameOrg = renameOrg;
+exports.provisionOrg = provisionOrg;
+exports.setOrgCurrency = setOrgCurrency;
+exports.getOrgTokens = getOrgTokens;
+/**
+ * US-OP-9 (T2 of v0.1.7). Cross-org overview for platform operators.
+ * Filter flags pass through to the backend's `listForOperator` filter set.
+ * Query param names are kebab-case to mirror the CLI flag names.
+ */
+async function listOrgs(client, args) {
+    return client.request('/platform/orgs', {
+        method: 'GET',
+        query: {
+            status: args.status,
+            'near-limit': args.nearLimit ? '1' : undefined,
+            'over-budget': args.overBudget ? '1' : undefined,
+            'quiet-since-days': args.quietSinceDays !== undefined ? String(args.quietSinceDays) : undefined,
+            'expiring-within-days': args.expiringWithinDays !== undefined
+                ? String(args.expiringWithinDays)
+                : undefined,
+            'sort-by': args.sortBy,
+        },
+    });
+}
+/** Rename a customer org's display name (operator action). */
+async function renameOrg(client, orgId, name) {
+    return client.request(`/platform/orgs/${encodeURIComponent(orgId)}/name`, { method: 'PATCH', body: { name } });
+}
+/**
+ * Provision a brand-new customer org + its admin user (operator action,
+ * sales-driven). Mirrors `POST /platform/orgs`. Token must carry `write:orgs`.
+ */
+async function provisionOrg(client, args) {
+    return client.request('/platform/orgs', {
+        method: 'POST',
+        body: {
+            orgName: args.orgName,
+            adminEmail: args.adminEmail,
+            adminName: args.adminName,
+            planId: args.planId,
+        },
+    });
+}
+/**
+ * Set a customer org's settlement currency + fixed contract rate (ADR-026).
+ * Mirrors `PATCH /platform/orgs/:orgId/currency`. Token must carry
+ * `write:billing`.
+ */
+async function setOrgCurrency(client, orgId, args) {
+    return client.request(`/platform/orgs/${encodeURIComponent(orgId)}/currency`, {
+        method: 'PATCH',
+        body: { currency: args.currency, contractRate: args.contractRate },
+    });
+}
+/**
+ * US-7 read slice (#435). Pass through the org's new-api token state for
+ * "is it LH or new-api?" triage. Read-only.
+ */
+async function getOrgTokens(client, orgId) {
+    return client.request(`/platform/orgs/${encodeURIComponent(orgId)}/tokens`, { method: 'GET' });
+}
+//# sourceMappingURL=index.js.map

package/dist/orgs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orgs/index.ts"],"names":[],"mappings":";;AAkCA,4BAmBC;AA0BD,8BASC;AAkCD,oCAaC;AAyBD,wCAYC;AAMD,oCAQC;AA7JD;;;;GAIG;AACI,KAAK,UAAU,QAAQ,CAC5B,MAAc,EACd,IAAkB;IAElB,OAAO,MAAM,CAAC,OAAO,CAAe,gBAAgB,EAAE;QACpD,MAAM,EAAE,KAAK;QACb,KAAK,EAAE;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;YAC9C,aAAa,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;YAChD,kBAAkB,EAChB,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;YAC7E,sBAAsB,EACpB,IAAI,CAAC,kBAAkB,KAAK,SAAS;gBACnC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC;gBACjC,CAAC,CAAC,SAAS;YACf,SAAS,EAAE,IAAI,CAAC,MAAM;SACvB;KACF,CAAC,CAAC;AACL,CAAC;AAyBD,8DAA8D;AACvD,KAAK,UAAU,SAAS,CAC7B,MAAc,EACd,KAAa,EACb,IAAY;IAEZ,OAAO,MAAM,CAAC,OAAO,CACnB,kBAAkB,kBAAkB,CAAC,KAAK,CAAC,OAAO,EAClD,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CACpC,CAAC;AACJ,CAAC;AA8BD;;;GAGG;AACI,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,IAAsB;IAEtB,OAAO,MAAM,CAAC,OAAO,CAAiB,gBAAgB,EAAE;QACtD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB;KACF,CAAC,CAAC;AACL,CAAC;AAoBD;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,KAAa,EACb,IAAwB;IAExB,OAAO,MAAM,CAAC,OAAO,CACnB,kBAAkB,kBAAkB,CAAC,KAAK,CAAC,WAAW,EACtD;QACE,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE;KACnE,CACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,KAAa;IAEb,OAAO,MAAM,CAAC,OAAO,CACnB,kBAAkB,kBAAkB,CAAC,KAAK,CAAC,SAAS,EACpD,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;AACJ,CAAC"}

package/dist/phase2/index.d.ts

@@ -0,0 +1,46 @@
+import { Client } from '../client';
+export interface Phase2Flags {
+    opsTeamSize: number;
+    hasNontech: boolean;
+    complianceAsk: boolean;
+    salesDemoRequested: boolean;
+}
+export interface Phase2Trigger {
+    id: 1 | 2 | 3;
+    name: string;
+    satisfied: boolean;
+    detail: string;
+}
+export interface Phase2State {
+    triggers: Phase2Trigger[];
+    satisfied: number;
+    activeOrgCount: number;
+    flags: Phase2Flags;
+}
+export declare const DEFAULT_STATE_PATH: string;
+export declare const PHASE2_BANNER = ">>> ADR-012 Phase 2 trigger met \u2014 schedule new ADR <<<";
+/**
+ * Pure-logic evaluator (no IO). Same function used by lh-ops `phase2-status`
+ * subcommand and lh-ops-skill `phase2_status` MCP tool.
+ */
+export declare function evaluatePhase2State(flags: Phase2Flags, activeOrgCount: number): Phase2State;
+/**
+ * Load manual flags from disk. Returns DEFAULT_FLAGS (all-false-ish) when
+ * the state file doesn't exist — common for fresh installs.
+ */
+export declare function loadPhase2Flags(filePath?: string): Promise<Phase2Flags>;
+/**
+ * Persist manual flags. CLI subcommand `lh-ops phase2-status set-*` uses this.
+ */
+export declare function savePhase2Flags(flags: Phase2Flags, filePath?: string): Promise<void>;
+export interface Phase2StatusResult extends Phase2State {
+    banner: string | null;
+}
+/**
+ * End-to-end: fetch live activeOrgCount + load flags + evaluate + decorate
+ * with banner. Both CLI and MCP call this; the differences are presentation
+ * (CLI renders ASCII checklist; MCP returns structured JSON).
+ */
+export declare function phase2Status(client: Client, opts?: {
+    statePath?: string;
+}): Promise<Phase2StatusResult>;

package/dist/phase2/index.js

@@ -0,0 +1,120 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PHASE2_BANNER = exports.DEFAULT_STATE_PATH = void 0;
+exports.evaluatePhase2State = evaluatePhase2State;
+exports.loadPhase2Flags = loadPhase2Flags;
+exports.savePhase2Flags = savePhase2Flags;
+exports.phase2Status = phase2Status;
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path = __importStar(require("path"));
+exports.DEFAULT_STATE_PATH = path.join((0, os_1.homedir)(), '.lh-ops', 'phase2-state.json');
+exports.PHASE2_BANNER = '>>> ADR-012 Phase 2 trigger met — schedule new ADR <<<';
+/**
+ * Pure-logic evaluator (no IO). Same function used by lh-ops `phase2-status`
+ * subcommand and lh-ops-skill `phase2_status` MCP tool.
+ */
+function evaluatePhase2State(flags, activeOrgCount) {
+    const triggers = [
+        {
+            id: 1,
+            name: 'Ops team ≥ 3 with non-technical member',
+            satisfied: flags.opsTeamSize >= 3 && flags.hasNontech,
+            detail: `opsTeamSize=${flags.opsTeamSize}, hasNontech=${flags.hasNontech}`,
+        },
+        {
+            id: 2,
+            name: 'Paid customers ≥ 5 + at least 1 compliance ask',
+            satisfied: activeOrgCount >= 5 && flags.complianceAsk,
+            detail: `activeOrgs=${activeOrgCount}, complianceAsk=${flags.complianceAsk}`,
+        },
+        {
+            id: 3,
+            name: 'Sales requested customer-facing audit-trail demo',
+            satisfied: flags.salesDemoRequested,
+            detail: `salesDemoRequested=${flags.salesDemoRequested}`,
+        },
+    ];
+    const satisfied = triggers.filter((t) => t.satisfied).length;
+    return { triggers, satisfied, activeOrgCount, flags };
+}
+const DEFAULT_FLAGS = {
+    opsTeamSize: 1,
+    hasNontech: false,
+    complianceAsk: false,
+    salesDemoRequested: false,
+};
+/**
+ * Load manual flags from disk. Returns DEFAULT_FLAGS (all-false-ish) when
+ * the state file doesn't exist — common for fresh installs.
+ */
+async function loadPhase2Flags(filePath = exports.DEFAULT_STATE_PATH) {
+    try {
+        const raw = await fs_1.promises.readFile(filePath, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return { ...DEFAULT_FLAGS };
+        }
+        throw err;
+    }
+}
+/**
+ * Persist manual flags. CLI subcommand `lh-ops phase2-status set-*` uses this.
+ */
+async function savePhase2Flags(flags, filePath = exports.DEFAULT_STATE_PATH) {
+    await fs_1.promises.mkdir(path.dirname(filePath), { recursive: true, mode: 0o700 });
+    await fs_1.promises.writeFile(filePath, JSON.stringify(flags, null, 2), { mode: 0o600 });
+}
+/**
+ * End-to-end: fetch live activeOrgCount + load flags + evaluate + decorate
+ * with banner. Both CLI and MCP call this; the differences are presentation
+ * (CLI renders ASCII checklist; MCP returns structured JSON).
+ */
+async function phase2Status(client, opts = {}) {
+    const orgs = await client.request('/platform/orgs', {
+        method: 'GET',
+        query: { status: 'ACTIVE' },
+    });
+    const flags = await loadPhase2Flags(opts.statePath);
+    const state = evaluatePhase2State(flags, orgs.length);
+    return {
+        ...state,
+        banner: state.satisfied >= 2 ? exports.PHASE2_BANNER : null,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/phase2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/phase2/index.ts"],"names":[],"mappings":"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"}

package/dist/plan/index.d.ts

@@ -0,0 +1,52 @@
+import { Client } from '../client';
+/**
+ * Plan SKU as returned by `/platform/plans` (mirrors the Prisma `Plan` model).
+ * `family` / `tier` are backend enums kept as `string` here so adding an enum
+ * value doesn't force a client release. Additive backend fields don't require
+ * changes here unless a consumer wants to surface them.
+ */
+export interface PlanQuota {
+    dimension: string;
+    limit: number;
+    window: string;
+}
+export type PlanStatus = 'ACTIVE' | 'ARCHIVED';
+export interface Plan {
+    id: string;
+    family: string;
+    tier: string;
+    displayName: string;
+    quotas: PlanQuota[];
+    status: PlanStatus;
+    isBaseTier: boolean;
+    createdAt: string;
+    /** ISO timestamp — also the optimistic-lock token for update/archive. */
+    updatedAt: string;
+}
+export interface ListPlansArgs {
+    family?: string;
+    status?: string;
+}
+/** US-1. List plan SKUs, optionally filtered by family / status. */
+export declare function listPlans(client: Client, args?: ListPlansArgs): Promise<Plan[]>;
+/** US-1. Fetch a single plan (also the source of the `updatedAt` lock token). */
+export declare function getPlan(client: Client, planId: string): Promise<Plan>;
+/** Mutable fields on PATCH /platform/plans/:id (mirrors backend UpdatePlanDto). */
+export interface UpdatePlanInput {
+    displayName?: string;
+    quotas?: PlanQuota[];
+    status?: PlanStatus;
+    isBaseTier?: boolean;
+}
+/**
+ * US-1. Update a plan. The backend enforces an optimistic lock: `ifMatch` must
+ * equal the plan's current `updatedAt` (get it from `getPlan`). Omitting it
+ * yields HTTP 412; a stale value yields 409.
+ */
+export declare function updatePlan(client: Client, planId: string, dto: UpdatePlanInput, ifMatch?: string): Promise<Plan>;
+/**
+ * US-1. Archive a plan (status → ARCHIVED). Same optimistic-lock contract as
+ * `updatePlan`. Archived plans stop appearing in the enterprise selection list
+ * but existing subscriptions keep running to commitmentEnd.
+ */
+export declare function archivePlan(client: Client, planId: string, ifMatch?: string): Promise<Plan>;

package/dist/plan/index.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listPlans = listPlans;
+exports.getPlan = getPlan;
+exports.updatePlan = updatePlan;
+exports.archivePlan = archivePlan;
+/** US-1. List plan SKUs, optionally filtered by family / status. */
+async function listPlans(client, args = {}) {
+    return client.request('/platform/plans', {
+        method: 'GET',
+        query: { family: args.family, status: args.status },
+    });
+}
+/** US-1. Fetch a single plan (also the source of the `updatedAt` lock token). */
+async function getPlan(client, planId) {
+    return client.request(`/platform/plans/${encodeURIComponent(planId)}`, { method: 'GET' });
+}
+/**
+ * US-1. Update a plan. The backend enforces an optimistic lock: `ifMatch` must
+ * equal the plan's current `updatedAt` (get it from `getPlan`). Omitting it
+ * yields HTTP 412; a stale value yields 409.
+ */
+async function updatePlan(client, planId, dto, ifMatch) {
+    return client.request(`/platform/plans/${encodeURIComponent(planId)}`, {
+        method: 'PATCH',
+        body: dto,
+        headers: ifMatch ? { 'if-match': ifMatch } : undefined,
+    });
+}
+/**
+ * US-1. Archive a plan (status → ARCHIVED). Same optimistic-lock contract as
+ * `updatePlan`. Archived plans stop appearing in the enterprise selection list
+ * but existing subscriptions keep running to commitmentEnd.
+ */
+async function archivePlan(client, planId, ifMatch) {
+    return client.request(`/platform/plans/${encodeURIComponent(planId)}/archive`, {
+        method: 'POST',
+        headers: ifMatch ? { 'if-match': ifMatch } : undefined,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/plan/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plan/index.ts"],"names":[],"mappings":";;AAmCA,8BAQC;AAGD,0BAKC;AAeD,gCAcC;AAOD,kCAYC;AAjED,oEAAoE;AAC7D,KAAK,UAAU,SAAS,CAC7B,MAAc,EACd,OAAsB,EAAE;IAExB,OAAO,MAAM,CAAC,OAAO,CAAS,iBAAiB,EAAE;QAC/C,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;KACpD,CAAC,CAAC;AACL,CAAC;AAED,iFAAiF;AAC1E,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,MAAc;IAC1D,OAAO,MAAM,CAAC,OAAO,CACnB,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAC/C,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;AACJ,CAAC;AAUD;;;;GAIG;AACI,KAAK,UAAU,UAAU,CAC9B,MAAc,EACd,MAAc,EACd,GAAoB,EACpB,OAAgB;IAEhB,OAAO,MAAM,CAAC,OAAO,CACnB,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAC/C;QACE,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,GAAG;QACT,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;KACvD,CACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,MAAc,EACd,OAAgB;IAEhB,OAAO,MAAM,CAAC,OAAO,CACnB,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,UAAU,EACvD;QACE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;KACvD,CACF,CAAC;AACJ,CAAC"}

package/dist/platform-token/index.d.ts

@@ -0,0 +1,37 @@
+import { Client } from '../client';
+export interface IssueTokenArgs {
+    /** One or more scopes from the KNOWN_SCOPES taxonomy (e.g. read:keys). */
+    scopes: string[];
+    /** Human label shown in `token list`. */
+    label?: string;
+    /** Token lifetime in days; omit for a non-expiring token. */
+    expiresInDays?: number;
+}
+/** Response of `POST /platform/tokens` — `token` plaintext is shown ONCE. */
+export interface IssuedToken {
+    id: string;
+    tokenPrefix: string;
+    scopes: string[];
+    label: string | null;
+    expiresAt: string | null;
+    /** The `lh_pat_…` plaintext — only present on issue, never stored/returned again. */
+    token: string;
+}
+/** Row from `GET /platform/tokens` — never includes the hash or plaintext. */
+export interface TokenSummary {
+    id: string;
+    tokenPrefix: string;
+    scopes: string[];
+    label: string | null;
+    status: string;
+    lastUsedAt: string | null;
+    expiresAt: string | null;
+    createdAt: string;
+    revokedAt: string | null;
+}
+export declare function issuePlatformToken(client: Client, args: IssueTokenArgs): Promise<IssuedToken>;
+export declare function listPlatformTokens(client: Client): Promise<TokenSummary[]>;
+export declare function revokePlatformToken(client: Client, id: string): Promise<{
+    id: string;
+    status: string;
+}>;

package/dist/platform-token/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.issuePlatformToken = issuePlatformToken;
+exports.listPlatformTokens = listPlatformTokens;
+exports.revokePlatformToken = revokePlatformToken;
+async function issuePlatformToken(client, args) {
+    return client.request('/platform/tokens', {
+        method: 'POST',
+        body: {
+            scopes: args.scopes,
+            label: args.label,
+            expiresInDays: args.expiresInDays,
+        },
+    });
+}
+async function listPlatformTokens(client) {
+    return client.request('/platform/tokens', { method: 'GET' });
+}
+async function revokePlatformToken(client, id) {
+    return client.request(`/platform/tokens/${encodeURIComponent(id)}/revoke`, { method: 'POST' });
+}
+//# sourceMappingURL=index.js.map

package/dist/platform-token/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/platform-token/index.ts"],"names":[],"mappings":";;AAuCA,gDAYC;AAED,gDAIC;AAED,kDAQC;AA5BM,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,IAAoB;IAEpB,OAAO,MAAM,CAAC,OAAO,CAAc,kBAAkB,EAAE;QACrD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;YACJ,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC;KACF,CAAC,CAAC;AACL,CAAC;AAEM,KAAK,UAAU,kBAAkB,CACtC,MAAc;IAEd,OAAO,MAAM,CAAC,OAAO,CAAiB,kBAAkB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/E,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,EAAU;IAEV,OAAO,MAAM,CAAC,OAAO,CACnB,oBAAoB,kBAAkB,CAAC,EAAE,CAAC,SAAS,EACnD,EAAE,MAAM,EAAE,MAAM,EAAE,CACnB,CAAC;AACJ,CAAC"}

package/dist/price-book/index.d.ts

@@ -0,0 +1,17 @@
+import { Client } from '../client';
+/**
+ * A price book version as returned by `GET /platform/pricebook` (mirrors the
+ * Prisma `PriceBook` model). There is no `status` enum — `isActive` marks the
+ * single live version; all others are historical.
+ */
+export interface PriceBookSummary {
+    id: string;
+    version: string;
+    effectiveFrom: string;
+    isActive: boolean;
+    createdAt: string;
+    /** Map of model → price; omitted by some list projections. */
+    modelPrices?: Record<string, unknown>;
+}
+/** US-2. List every price book version (active + historical). */
+export declare function listPriceBooks(client: Client): Promise<PriceBookSummary[]>;

package/dist/price-book/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listPriceBooks = listPriceBooks;
+/** US-2. List every price book version (active + historical). */
+async function listPriceBooks(client) {
+    return client.request('/platform/pricebook', {
+        method: 'GET',
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/price-book/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/price-book/index.ts"],"names":[],"mappings":";;AAkBA,wCAMC;AAPD,iEAAiE;AAC1D,KAAK,UAAU,cAAc,CAClC,MAAc;IAEd,OAAO,MAAM,CAAC,OAAO,CAAqB,qBAAqB,EAAE;QAC/D,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/statement/index.d.ts

@@ -0,0 +1,38 @@
+import { Client } from '../client';
+/**
+ * Response payload from `GET /platform/orgs/:orgId/statement?month=YYYY-MM`.
+ * US-OP-10 (T3 of v0.1.7) monthly checkpoint.
+ */
+export interface StatementPayload {
+    orgId: string;
+    month: string;
+    periodStart: string;
+    periodEnd: string;
+    consumption: Array<{
+        subscriptionId: string;
+        model: string;
+        requestCount: number;
+        promptTokens: number;
+        completionTokens: number;
+        cost: string;
+    }>;
+    balance: {
+        starting: string;
+        topups: string;
+        charges: string;
+        ending: string;
+    };
+    keys: {
+        activeStart: number;
+        activeEnd: number;
+        newInPeriod: number;
+        revokedInPeriod: number;
+        dormancyInPeriod: number;
+    };
+    reconciliationHash: string;
+}
+export interface GetStatementArgs {
+    orgId: string;
+    month: string;
+}
+export declare function getStatement(client: Client, args: GetStatementArgs): Promise<StatementPayload>;

package/dist/statement/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStatement = getStatement;
+async function getStatement(client, args) {
+    return client.request(`/platform/orgs/${encodeURIComponent(args.orgId)}/statement`, {
+        method: 'GET',
+        query: { month: args.month },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/statement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/statement/index.ts"],"names":[],"mappings":";;AAwCA,oCAWC;AAXM,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,IAAsB;IAEtB,OAAO,MAAM,CAAC,OAAO,CACnB,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,EAC5D;QACE,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;KAC7B,CACF,CAAC;AACJ,CAAC"}

package/dist/subscription/index.d.ts

@@ -0,0 +1,45 @@
+import { Client } from '../client';
+/** A subscription row (mirrors the Prisma `Subscription` model's public fields). */
+export interface Subscription {
+    id: string;
+    orgId: string;
+    planId: string;
+    maxKeys: number;
+    contractStart: string;
+    commitmentEnd: string;
+    priceBookVersion: string;
+    status: 'ACTIVE' | 'EXPIRED' | 'CANCELLED';
+    isBaseTier: boolean;
+}
+export interface ExtendContractArgs {
+    /** New ISO8601 commitmentEnd — must be in the future and later than current. */
+    commitmentEnd: string;
+    memo?: string;
+}
+/**
+ * US-8 (#29): extend a subscription's contract commitment (renewal). Per
+ * subscription (an org holds many — ADR-014). Only `commitmentEnd` moves;
+ * tier/quota changes go through re-subscribe (cancel + add).
+ */
+export declare function extendContract(client: Client, orgId: string, subId: string, args: ExtendContractArgs): Promise<Subscription>;
+/**
+ * Body for `POST /platform/orgs/:orgId/subscriptions` (AddSubscriptionDto, #83).
+ * `priceBookVersion` is optional — the service captures the active version when
+ * omitted (sales-driven motion). Date-relationship checks live server-side.
+ */
+export interface AddSubscriptionArgs {
+    planId: string;
+    /** Max keys for this subscription (integer ≥ 1). */
+    maxKeys: number;
+    /** ISO8601 contract start. */
+    contractStart: string;
+    /** ISO8601 commitment end — must be in the future and later than contractStart. */
+    commitmentEnd: string;
+    priceBookVersion?: string;
+}
+/**
+ * Add an additional (paid) subscription to an already-existing org — operator
+ * change-order motion (#83, ADR-014: an org holds many subs). Mirrors
+ * `POST /platform/orgs/:orgId/subscriptions`. Token must carry `write:orgs`.
+ */
+export declare function addSubscription(client: Client, orgId: string, args: AddSubscriptionArgs): Promise<Subscription>;