@billfn/admin 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,897 @@
+import { type AdminClient, type AdminClientRequestOptions, type AdminCapabilityAdapter, type AdminObjectSchema, type AdminOperationContext, type AdminOperationDefinition, type AdminOperationResult } from "@superfunctions/admin";
+export interface BillFnAdminResourceDefinition {
+    id: string;
+    label: string;
+    description: string;
+    icon: string;
+    risk: "standard" | "sensitive";
+    idField: string;
+    displayFields: readonly string[];
+    searchableFields: readonly string[];
+    filterableFields: readonly string[];
+    sortableFields: readonly string[];
+    sensitiveFields: readonly string[];
+}
+export interface BillFnAdminActionDefinition {
+    id: string;
+    resource: string;
+    title: string;
+    description: string;
+    classification: "write" | "destructive";
+    requiresConfirmation: boolean;
+    idempotent: true;
+    target: "resource" | "collection";
+}
+export declare const billFnAdminResources: readonly [{
+    readonly id: "customers";
+    readonly label: "Customers";
+    readonly description: "Inspect and operate customers in BillFn.";
+    readonly icon: "billfn:customers";
+    readonly risk: "standard";
+    readonly idField: "id";
+    readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+    readonly searchableFields: readonly ["id", "name", "status"];
+    readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+    readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+    readonly sensitiveFields: readonly [];
+}, {
+    readonly id: "products";
+    readonly label: "Products";
+    readonly description: "Inspect and operate products in BillFn.";
+    readonly icon: "billfn:products";
+    readonly risk: "standard";
+    readonly idField: "id";
+    readonly displayFields: readonly ["id", "productKey", "planCount"];
+    readonly searchableFields: readonly ["id", "productKey"];
+    readonly filterableFields: readonly ["productKey", "planCount"];
+    readonly sortableFields: readonly ["productKey", "planCount"];
+    readonly sensitiveFields: readonly [];
+}, {
+    readonly id: "plans";
+    readonly label: "Plans";
+    readonly description: "Inspect and operate plans in BillFn.";
+    readonly icon: "billfn:plans";
+    readonly risk: "standard";
+    readonly idField: "id";
+    readonly displayFields: readonly ["id", "displayName", "productKey", "planKey"];
+    readonly searchableFields: readonly ["id", "displayName", "productKey", "planKey"];
+    readonly filterableFields: readonly ["productKey", "planKey"];
+    readonly sortableFields: readonly ["displayName", "productKey", "planKey"];
+    readonly sensitiveFields: readonly [];
+}, {
+    readonly id: "prices";
+    readonly label: "Prices";
+    readonly description: "Inspect and operate prices in BillFn.";
+    readonly icon: "billfn:prices";
+    readonly risk: "standard";
+    readonly idField: "id";
+    readonly displayFields: readonly ["id", "displayName", "amount", "currency", "interval", "provider"];
+    readonly searchableFields: readonly ["id", "displayName", "priceId", "planKey", "productKey", "provider"];
+    readonly filterableFields: readonly ["provider", "currency", "kind", "interval", "planKey", "productKey"];
+    readonly sortableFields: readonly ["amount", "currency", "displayName", "interval", "provider"];
+    readonly sensitiveFields: readonly [];
+}, {
+    readonly id: "subscriptions";
+    readonly label: "Subscriptions";
+    readonly description: "Inspect and operate subscriptions in BillFn.";
+    readonly icon: "billfn:subscriptions";
+    readonly risk: "standard";
+    readonly idField: "id";
+    readonly displayFields: readonly ["id", "planKey", "status", "provider", "currentPeriodEnd", "updatedAt"];
+    readonly searchableFields: readonly ["id", "planKey", "priceId", "provider", "status"];
+    readonly filterableFields: readonly ["planKey", "provider", "status"];
+    readonly sortableFields: readonly ["createdAt", "currentPeriodEnd", "status", "updatedAt"];
+    readonly sensitiveFields: readonly [];
+}, {
+    readonly id: "entitlements";
+    readonly label: "Entitlements";
+    readonly description: "Inspect and operate entitlements in BillFn.";
+    readonly icon: "billfn:entitlements";
+    readonly risk: "standard";
+    readonly idField: "id";
+    readonly displayFields: readonly ["id", "planKey", "status", "effectiveAt", "expiresAt", "updatedAt"];
+    readonly searchableFields: readonly ["id", "planKey", "status"];
+    readonly filterableFields: readonly ["planKey", "status"];
+    readonly sortableFields: readonly ["createdAt", "effectiveAt", "expiresAt", "updatedAt"];
+    readonly sensitiveFields: readonly [];
+}, {
+    readonly id: "quotas";
+    readonly label: "Quotas";
+    readonly description: "Inspect and operate quotas in BillFn.";
+    readonly icon: "billfn:quotas";
+    readonly risk: "standard";
+    readonly idField: "id";
+    readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+    readonly searchableFields: readonly ["id", "name", "status"];
+    readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+    readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+    readonly sensitiveFields: readonly [];
+}, {
+    readonly id: "invoices";
+    readonly label: "Invoices";
+    readonly description: "Inspect and operate invoices in BillFn.";
+    readonly icon: "billfn:invoices";
+    readonly risk: "standard";
+    readonly idField: "id";
+    readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+    readonly searchableFields: readonly ["id", "name", "status"];
+    readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+    readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+    readonly sensitiveFields: readonly [];
+}, {
+    readonly id: "payments";
+    readonly label: "Payments";
+    readonly description: "Inspect and operate payments in BillFn.";
+    readonly icon: "billfn:payments";
+    readonly risk: "sensitive";
+    readonly idField: "id";
+    readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+    readonly searchableFields: readonly ["id", "name", "status"];
+    readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+    readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+    readonly sensitiveFields: readonly ["secret", "token", "credential", "value", "password", "passwd", "apiKey", "privateKey", "authorization", "cookie", "otp", "otpCode", "recoveryCode", "recoveryCodes", "verificationCode", "sessionToken"];
+}, {
+    readonly id: "usage";
+    readonly label: "Usage";
+    readonly description: "Inspect and operate usage in BillFn.";
+    readonly icon: "billfn:usage";
+    readonly risk: "standard";
+    readonly idField: "id";
+    readonly displayFields: readonly ["id", "resource", "current", "limit"];
+    readonly searchableFields: readonly ["id", "resource"];
+    readonly filterableFields: readonly ["resource"];
+    readonly sortableFields: readonly ["current", "limit", "resource"];
+    readonly sensitiveFields: readonly [];
+}, {
+    readonly id: "reconciliation";
+    readonly label: "Reconciliation";
+    readonly description: "Inspect and operate reconciliation in BillFn.";
+    readonly icon: "billfn:reconciliation";
+    readonly risk: "standard";
+    readonly idField: "id";
+    readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+    readonly searchableFields: readonly ["id", "name", "status"];
+    readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+    readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+    readonly sensitiveFields: readonly [];
+}, {
+    readonly id: "revenue";
+    readonly label: "Revenue";
+    readonly description: "Inspect and operate revenue in BillFn.";
+    readonly icon: "billfn:revenue";
+    readonly risk: "standard";
+    readonly idField: "id";
+    readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+    readonly searchableFields: readonly ["id", "name", "status"];
+    readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+    readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+    readonly sensitiveFields: readonly [];
+}];
+export declare const billFnAdminActions: readonly [{
+    readonly id: "create-catalog";
+    readonly resource: "products";
+    readonly title: "Create Catalog";
+    readonly description: "Create Catalog for products.";
+    readonly classification: "write";
+    readonly requiresConfirmation: false;
+    readonly idempotent: true;
+    readonly target: "collection";
+}, {
+    readonly id: "update-catalog";
+    readonly resource: "products";
+    readonly title: "Update Catalog";
+    readonly description: "Update Catalog for products.";
+    readonly classification: "write";
+    readonly requiresConfirmation: false;
+    readonly idempotent: true;
+    readonly target: "resource";
+}, {
+    readonly id: "grant-entitlement";
+    readonly resource: "entitlements";
+    readonly title: "Grant Entitlement";
+    readonly description: "Grant Entitlement for entitlements.";
+    readonly classification: "write";
+    readonly requiresConfirmation: false;
+    readonly idempotent: true;
+    readonly target: "resource";
+}, {
+    readonly id: "change-subscription";
+    readonly resource: "subscriptions";
+    readonly title: "Change Subscription";
+    readonly description: "Change Subscription for subscriptions.";
+    readonly classification: "write";
+    readonly requiresConfirmation: true;
+    readonly idempotent: true;
+    readonly target: "resource";
+}, {
+    readonly id: "cancel-subscription";
+    readonly resource: "subscriptions";
+    readonly title: "Cancel Subscription";
+    readonly description: "Cancel Subscription for subscriptions.";
+    readonly classification: "destructive";
+    readonly requiresConfirmation: true;
+    readonly idempotent: true;
+    readonly target: "resource";
+}, {
+    readonly id: "issue-credit";
+    readonly resource: "invoices";
+    readonly title: "Issue Credit";
+    readonly description: "Issue Credit for invoices.";
+    readonly classification: "write";
+    readonly requiresConfirmation: false;
+    readonly idempotent: true;
+    readonly target: "resource";
+}, {
+    readonly id: "refund-payment";
+    readonly resource: "payments";
+    readonly title: "Refund Payment";
+    readonly description: "Refund Payment for payments.";
+    readonly classification: "write";
+    readonly requiresConfirmation: true;
+    readonly idempotent: true;
+    readonly target: "resource";
+}, {
+    readonly id: "reconcile-provider";
+    readonly resource: "reconciliation";
+    readonly title: "Reconcile Provider";
+    readonly description: "Reconcile Provider for reconciliation.";
+    readonly classification: "write";
+    readonly requiresConfirmation: true;
+    readonly idempotent: true;
+    readonly target: "collection";
+}];
+export interface BillFnAdminResourcePolicy {
+    defaultScope: "active";
+    permission: string;
+    redaction: "none" | "sensitive-fields";
+}
+export interface BillFnAdminOperationPolicy {
+    permission: string;
+    scope: {
+        levels: readonly ["organization", "workspace", "project", "environment"];
+        forwardsNamespace: true;
+        forwardsRegion: true;
+    };
+    safety: {
+        classification: "write" | "destructive";
+        requiresConfirmation: boolean;
+    };
+    idempotency: {
+        mode: "required";
+        keyStrategy: "context.idempotencyKey";
+    };
+    audit: {
+        mode: "required";
+        action: string;
+        targetResource: string;
+        targetIdPath?: "$.id";
+        collection?: true;
+    };
+    observation: {
+        domain: "billfn";
+        requestIdPath: "context.requestId";
+        correlationIdPath: "context.correlationId";
+    };
+}
+export declare const billFnAdminResourcePolicies: Readonly<Record<string, BillFnAdminResourcePolicy>>;
+export declare const billFnAdminOperationPolicies: Readonly<Record<string, BillFnAdminOperationPolicy>>;
+export declare const billFnAdminSchemas: {
+    readonly entity: AdminObjectSchema;
+    readonly listInput: AdminObjectSchema;
+    readonly listOutput: AdminObjectSchema;
+    readonly getInput: AdminObjectSchema;
+    readonly getOutput: AdminObjectSchema;
+    readonly actionInput: AdminObjectSchema;
+    readonly actionOutput: AdminObjectSchema;
+};
+type FunctionAdminActionOperationId<TModule extends string, TAction> = TAction extends {
+    resource: infer TResource extends string;
+    id: infer TActionId extends string;
+} ? `${TModule}.${TResource}.${TActionId}` : never;
+type BillFnDomainReadResourceId = "products" | "plans" | "prices" | "subscriptions" | "entitlements" | "usage";
+type BillFnDomainAction = Extract<(typeof billFnAdminActions)[number], {
+    id: "change-subscription" | "cancel-subscription" | "refund-payment" | "reconcile-provider";
+}>;
+export type BillFnAdminOperationId = `billfn.${BillFnDomainReadResourceId}.list` | `billfn.${BillFnDomainReadResourceId}.get` | FunctionAdminActionOperationId<"billfn", BillFnDomainAction>;
+export declare const billFnAdminCapability: {
+    readonly schemaVersion: "1.0";
+    readonly id: "billfn";
+    readonly displayName: "BillFn";
+    readonly version: "1.0.0";
+    readonly description: "Function-owned BillFn operator capabilities backed by the configured billing instance.";
+    readonly category: "commerce";
+    readonly availability: "required-product";
+    readonly scopeLevels: readonly ["organization", "workspace", "project", "environment"];
+    readonly dependencies: readonly [];
+    readonly resources: ({
+        readonly id: "customers";
+        readonly label: "Customers";
+        readonly description: "Inspect and operate customers in BillFn.";
+        readonly icon: "billfn:customers";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "products";
+        readonly label: "Products";
+        readonly description: "Inspect and operate products in BillFn.";
+        readonly icon: "billfn:products";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "productKey", "planCount"];
+        readonly searchableFields: readonly ["id", "productKey"];
+        readonly filterableFields: readonly ["productKey", "planCount"];
+        readonly sortableFields: readonly ["productKey", "planCount"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "plans";
+        readonly label: "Plans";
+        readonly description: "Inspect and operate plans in BillFn.";
+        readonly icon: "billfn:plans";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "displayName", "productKey", "planKey"];
+        readonly searchableFields: readonly ["id", "displayName", "productKey", "planKey"];
+        readonly filterableFields: readonly ["productKey", "planKey"];
+        readonly sortableFields: readonly ["displayName", "productKey", "planKey"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "prices";
+        readonly label: "Prices";
+        readonly description: "Inspect and operate prices in BillFn.";
+        readonly icon: "billfn:prices";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "displayName", "amount", "currency", "interval", "provider"];
+        readonly searchableFields: readonly ["id", "displayName", "priceId", "planKey", "productKey", "provider"];
+        readonly filterableFields: readonly ["provider", "currency", "kind", "interval", "planKey", "productKey"];
+        readonly sortableFields: readonly ["amount", "currency", "displayName", "interval", "provider"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "subscriptions";
+        readonly label: "Subscriptions";
+        readonly description: "Inspect and operate subscriptions in BillFn.";
+        readonly icon: "billfn:subscriptions";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "planKey", "status", "provider", "currentPeriodEnd", "updatedAt"];
+        readonly searchableFields: readonly ["id", "planKey", "priceId", "provider", "status"];
+        readonly filterableFields: readonly ["planKey", "provider", "status"];
+        readonly sortableFields: readonly ["createdAt", "currentPeriodEnd", "status", "updatedAt"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "entitlements";
+        readonly label: "Entitlements";
+        readonly description: "Inspect and operate entitlements in BillFn.";
+        readonly icon: "billfn:entitlements";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "planKey", "status", "effectiveAt", "expiresAt", "updatedAt"];
+        readonly searchableFields: readonly ["id", "planKey", "status"];
+        readonly filterableFields: readonly ["planKey", "status"];
+        readonly sortableFields: readonly ["createdAt", "effectiveAt", "expiresAt", "updatedAt"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "quotas";
+        readonly label: "Quotas";
+        readonly description: "Inspect and operate quotas in BillFn.";
+        readonly icon: "billfn:quotas";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "invoices";
+        readonly label: "Invoices";
+        readonly description: "Inspect and operate invoices in BillFn.";
+        readonly icon: "billfn:invoices";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "payments";
+        readonly label: "Payments";
+        readonly description: "Inspect and operate payments in BillFn.";
+        readonly icon: "billfn:payments";
+        readonly risk: "sensitive";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly ["secret", "token", "credential", "value", "password", "passwd", "apiKey", "privateKey", "authorization", "cookie", "otp", "otpCode", "recoveryCode", "recoveryCodes", "verificationCode", "sessionToken"];
+    } | {
+        readonly id: "usage";
+        readonly label: "Usage";
+        readonly description: "Inspect and operate usage in BillFn.";
+        readonly icon: "billfn:usage";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "resource", "current", "limit"];
+        readonly searchableFields: readonly ["id", "resource"];
+        readonly filterableFields: readonly ["resource"];
+        readonly sortableFields: readonly ["current", "limit", "resource"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "reconciliation";
+        readonly label: "Reconciliation";
+        readonly description: "Inspect and operate reconciliation in BillFn.";
+        readonly icon: "billfn:reconciliation";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "revenue";
+        readonly label: "Revenue";
+        readonly description: "Inspect and operate revenue in BillFn.";
+        readonly icon: "billfn:revenue";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    })[];
+    readonly navigation: readonly [{
+        readonly id: "billfn";
+        readonly label: "BillFn";
+        readonly path: "/modules/billfn";
+        readonly icon: "billfn";
+        readonly description: "Operate BillFn in the active scope.";
+        readonly order: 100;
+    }];
+    readonly operations: readonly (AdminOperationDefinition & {
+        readonly id: BillFnAdminOperationId;
+    })[];
+};
+export interface BillFnAdminListInput {
+    filter?: Record<string, unknown>;
+    limit?: number;
+    cursor?: string;
+    search?: string;
+    sort?: readonly {
+        field?: string;
+        direction?: "asc" | "desc";
+    }[];
+}
+export interface BillFnAdminGetInput {
+    id: string;
+}
+export interface BillFnChangeSubscriptionInput {
+    id: string;
+    payload: {
+        targetPriceId: string;
+        effectiveAt?: "immediate" | "next_renewal";
+        prorationBehavior?: "provider_default" | "prorate" | "none";
+    };
+    reason?: string;
+}
+export interface BillFnCancelSubscriptionInput {
+    id: string;
+    reason?: string;
+}
+export interface BillFnRefundPaymentInput {
+    id: string;
+    payload: {
+        subscriptionId?: string;
+        mode?: "full" | "prorated_remaining_period" | "custom";
+        amount?: number;
+    };
+    reason?: string;
+}
+export interface BillFnReconcileProviderInput {
+    payload: {
+        kind: "subscription-sync" | "account-scan";
+        provider?: "dodo" | "apple" | "stripe" | "polar" | "google-play" | "microsoft-store";
+        billingAccountId?: string;
+        subscriptionId?: string;
+        providerEventId?: string;
+        cursor?: string;
+    };
+}
+type BillFnAdminResult = AdminOperationResult<Record<string, unknown>>;
+export declare function createBillFnAdminClient(adminClient: AdminClient): import("@superfunctions/admin").CapabilityAdminClient<{
+    readonly schemaVersion: "1.0";
+    readonly id: "billfn";
+    readonly displayName: "BillFn";
+    readonly version: "1.0.0";
+    readonly description: "Function-owned BillFn operator capabilities backed by the configured billing instance.";
+    readonly category: "commerce";
+    readonly availability: "required-product";
+    readonly scopeLevels: readonly ["organization", "workspace", "project", "environment"];
+    readonly dependencies: readonly [];
+    readonly resources: ({
+        readonly id: "customers";
+        readonly label: "Customers";
+        readonly description: "Inspect and operate customers in BillFn.";
+        readonly icon: "billfn:customers";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "products";
+        readonly label: "Products";
+        readonly description: "Inspect and operate products in BillFn.";
+        readonly icon: "billfn:products";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "productKey", "planCount"];
+        readonly searchableFields: readonly ["id", "productKey"];
+        readonly filterableFields: readonly ["productKey", "planCount"];
+        readonly sortableFields: readonly ["productKey", "planCount"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "plans";
+        readonly label: "Plans";
+        readonly description: "Inspect and operate plans in BillFn.";
+        readonly icon: "billfn:plans";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "displayName", "productKey", "planKey"];
+        readonly searchableFields: readonly ["id", "displayName", "productKey", "planKey"];
+        readonly filterableFields: readonly ["productKey", "planKey"];
+        readonly sortableFields: readonly ["displayName", "productKey", "planKey"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "prices";
+        readonly label: "Prices";
+        readonly description: "Inspect and operate prices in BillFn.";
+        readonly icon: "billfn:prices";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "displayName", "amount", "currency", "interval", "provider"];
+        readonly searchableFields: readonly ["id", "displayName", "priceId", "planKey", "productKey", "provider"];
+        readonly filterableFields: readonly ["provider", "currency", "kind", "interval", "planKey", "productKey"];
+        readonly sortableFields: readonly ["amount", "currency", "displayName", "interval", "provider"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "subscriptions";
+        readonly label: "Subscriptions";
+        readonly description: "Inspect and operate subscriptions in BillFn.";
+        readonly icon: "billfn:subscriptions";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "planKey", "status", "provider", "currentPeriodEnd", "updatedAt"];
+        readonly searchableFields: readonly ["id", "planKey", "priceId", "provider", "status"];
+        readonly filterableFields: readonly ["planKey", "provider", "status"];
+        readonly sortableFields: readonly ["createdAt", "currentPeriodEnd", "status", "updatedAt"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "entitlements";
+        readonly label: "Entitlements";
+        readonly description: "Inspect and operate entitlements in BillFn.";
+        readonly icon: "billfn:entitlements";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "planKey", "status", "effectiveAt", "expiresAt", "updatedAt"];
+        readonly searchableFields: readonly ["id", "planKey", "status"];
+        readonly filterableFields: readonly ["planKey", "status"];
+        readonly sortableFields: readonly ["createdAt", "effectiveAt", "expiresAt", "updatedAt"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "quotas";
+        readonly label: "Quotas";
+        readonly description: "Inspect and operate quotas in BillFn.";
+        readonly icon: "billfn:quotas";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "invoices";
+        readonly label: "Invoices";
+        readonly description: "Inspect and operate invoices in BillFn.";
+        readonly icon: "billfn:invoices";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "payments";
+        readonly label: "Payments";
+        readonly description: "Inspect and operate payments in BillFn.";
+        readonly icon: "billfn:payments";
+        readonly risk: "sensitive";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly ["secret", "token", "credential", "value", "password", "passwd", "apiKey", "privateKey", "authorization", "cookie", "otp", "otpCode", "recoveryCode", "recoveryCodes", "verificationCode", "sessionToken"];
+    } | {
+        readonly id: "usage";
+        readonly label: "Usage";
+        readonly description: "Inspect and operate usage in BillFn.";
+        readonly icon: "billfn:usage";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "resource", "current", "limit"];
+        readonly searchableFields: readonly ["id", "resource"];
+        readonly filterableFields: readonly ["resource"];
+        readonly sortableFields: readonly ["current", "limit", "resource"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "reconciliation";
+        readonly label: "Reconciliation";
+        readonly description: "Inspect and operate reconciliation in BillFn.";
+        readonly icon: "billfn:reconciliation";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "revenue";
+        readonly label: "Revenue";
+        readonly description: "Inspect and operate revenue in BillFn.";
+        readonly icon: "billfn:revenue";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    })[];
+    readonly navigation: readonly [{
+        readonly id: "billfn";
+        readonly label: "BillFn";
+        readonly path: "/modules/billfn";
+        readonly icon: "billfn";
+        readonly description: "Operate BillFn in the active scope.";
+        readonly order: 100;
+    }];
+    readonly operations: readonly (AdminOperationDefinition & {
+        readonly id: BillFnAdminOperationId;
+    })[];
+}> & {
+    products: {
+        list: (input?: BillFnAdminListInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+        get: (input: BillFnAdminGetInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+    };
+    plans: {
+        list: (input?: BillFnAdminListInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+        get: (input: BillFnAdminGetInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+    };
+    prices: {
+        list: (input?: BillFnAdminListInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+        get: (input: BillFnAdminGetInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+    };
+    subscriptions: {
+        change: (input: BillFnChangeSubscriptionInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+        cancel: (input: BillFnCancelSubscriptionInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+        list: (input?: BillFnAdminListInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+        get: (input: BillFnAdminGetInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+    };
+    entitlements: {
+        list: (input?: BillFnAdminListInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+        get: (input: BillFnAdminGetInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+    };
+    usage: {
+        list: (input?: BillFnAdminListInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+        get: (input: BillFnAdminGetInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+    };
+    payments: {
+        refund: (input: BillFnRefundPaymentInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+    };
+    reconciliation: {
+        run: (input: BillFnReconcileProviderInput, options?: AdminClientRequestOptions) => Promise<AdminOperationResult<unknown>>;
+    };
+};
+export interface BillFnAdminService {
+    listProducts(input: BillFnAdminListInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    getProduct(input: BillFnAdminGetInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    listPlans(input: BillFnAdminListInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    getPlan(input: BillFnAdminGetInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    listPrices(input: BillFnAdminListInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    getPrice(input: BillFnAdminGetInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    listSubscriptions(input: BillFnAdminListInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    getSubscription(input: BillFnAdminGetInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    listEntitlements(input: BillFnAdminListInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    getEntitlement(input: BillFnAdminGetInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    listUsage(input: BillFnAdminListInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    getUsage(input: BillFnAdminGetInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    changeSubscription(input: BillFnChangeSubscriptionInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    cancelSubscription(input: BillFnCancelSubscriptionInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    refundPayment(input: BillFnRefundPaymentInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+    reconcileProvider(input: BillFnReconcileProviderInput, context: AdminOperationContext): Promise<BillFnAdminResult>;
+}
+export declare function createBillFnAdminAdapter(service: BillFnAdminService): AdminCapabilityAdapter;
+export declare const adminCapability: {
+    readonly schemaVersion: "1.0";
+    readonly id: "billfn";
+    readonly displayName: "BillFn";
+    readonly version: "1.0.0";
+    readonly description: "Function-owned BillFn operator capabilities backed by the configured billing instance.";
+    readonly category: "commerce";
+    readonly availability: "required-product";
+    readonly scopeLevels: readonly ["organization", "workspace", "project", "environment"];
+    readonly dependencies: readonly [];
+    readonly resources: ({
+        readonly id: "customers";
+        readonly label: "Customers";
+        readonly description: "Inspect and operate customers in BillFn.";
+        readonly icon: "billfn:customers";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "products";
+        readonly label: "Products";
+        readonly description: "Inspect and operate products in BillFn.";
+        readonly icon: "billfn:products";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "productKey", "planCount"];
+        readonly searchableFields: readonly ["id", "productKey"];
+        readonly filterableFields: readonly ["productKey", "planCount"];
+        readonly sortableFields: readonly ["productKey", "planCount"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "plans";
+        readonly label: "Plans";
+        readonly description: "Inspect and operate plans in BillFn.";
+        readonly icon: "billfn:plans";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "displayName", "productKey", "planKey"];
+        readonly searchableFields: readonly ["id", "displayName", "productKey", "planKey"];
+        readonly filterableFields: readonly ["productKey", "planKey"];
+        readonly sortableFields: readonly ["displayName", "productKey", "planKey"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "prices";
+        readonly label: "Prices";
+        readonly description: "Inspect and operate prices in BillFn.";
+        readonly icon: "billfn:prices";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "displayName", "amount", "currency", "interval", "provider"];
+        readonly searchableFields: readonly ["id", "displayName", "priceId", "planKey", "productKey", "provider"];
+        readonly filterableFields: readonly ["provider", "currency", "kind", "interval", "planKey", "productKey"];
+        readonly sortableFields: readonly ["amount", "currency", "displayName", "interval", "provider"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "subscriptions";
+        readonly label: "Subscriptions";
+        readonly description: "Inspect and operate subscriptions in BillFn.";
+        readonly icon: "billfn:subscriptions";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "planKey", "status", "provider", "currentPeriodEnd", "updatedAt"];
+        readonly searchableFields: readonly ["id", "planKey", "priceId", "provider", "status"];
+        readonly filterableFields: readonly ["planKey", "provider", "status"];
+        readonly sortableFields: readonly ["createdAt", "currentPeriodEnd", "status", "updatedAt"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "entitlements";
+        readonly label: "Entitlements";
+        readonly description: "Inspect and operate entitlements in BillFn.";
+        readonly icon: "billfn:entitlements";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "planKey", "status", "effectiveAt", "expiresAt", "updatedAt"];
+        readonly searchableFields: readonly ["id", "planKey", "status"];
+        readonly filterableFields: readonly ["planKey", "status"];
+        readonly sortableFields: readonly ["createdAt", "effectiveAt", "expiresAt", "updatedAt"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "quotas";
+        readonly label: "Quotas";
+        readonly description: "Inspect and operate quotas in BillFn.";
+        readonly icon: "billfn:quotas";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "invoices";
+        readonly label: "Invoices";
+        readonly description: "Inspect and operate invoices in BillFn.";
+        readonly icon: "billfn:invoices";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "payments";
+        readonly label: "Payments";
+        readonly description: "Inspect and operate payments in BillFn.";
+        readonly icon: "billfn:payments";
+        readonly risk: "sensitive";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly ["secret", "token", "credential", "value", "password", "passwd", "apiKey", "privateKey", "authorization", "cookie", "otp", "otpCode", "recoveryCode", "recoveryCodes", "verificationCode", "sessionToken"];
+    } | {
+        readonly id: "usage";
+        readonly label: "Usage";
+        readonly description: "Inspect and operate usage in BillFn.";
+        readonly icon: "billfn:usage";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "resource", "current", "limit"];
+        readonly searchableFields: readonly ["id", "resource"];
+        readonly filterableFields: readonly ["resource"];
+        readonly sortableFields: readonly ["current", "limit", "resource"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "reconciliation";
+        readonly label: "Reconciliation";
+        readonly description: "Inspect and operate reconciliation in BillFn.";
+        readonly icon: "billfn:reconciliation";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    } | {
+        readonly id: "revenue";
+        readonly label: "Revenue";
+        readonly description: "Inspect and operate revenue in BillFn.";
+        readonly icon: "billfn:revenue";
+        readonly risk: "standard";
+        readonly idField: "id";
+        readonly displayFields: readonly ["id", "name", "status", "updatedAt"];
+        readonly searchableFields: readonly ["id", "name", "status"];
+        readonly filterableFields: readonly ["status", "createdAt", "updatedAt"];
+        readonly sortableFields: readonly ["createdAt", "updatedAt", "name"];
+        readonly sensitiveFields: readonly [];
+    })[];
+    readonly navigation: readonly [{
+        readonly id: "billfn";
+        readonly label: "BillFn";
+        readonly path: "/modules/billfn";
+        readonly icon: "billfn";
+        readonly description: "Operate BillFn in the active scope.";
+        readonly order: 100;
+    }];
+    readonly operations: readonly (AdminOperationDefinition & {
+        readonly id: BillFnAdminOperationId;
+    })[];
+};
+export declare const createAdminAdapter: typeof createBillFnAdminAdapter;
+export { createBillFnDomainAdminService, type BillFnDomainAdminServiceOptions, } from "./domain-service.js";
+//# sourceMappingURL=index.d.ts.map