@soledgic/sdk 0.2.2 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # Soledgic TypeScript SDK
 
-TypeScript client for Soledgic's public resource-first treasury API.
+TypeScript client for Soledgic's wallet-first payment infrastructure API for marketplaces, creator platforms, and closed-loop app economies.
 
 This package targets the supported API-key surface:
 
@@ -11,18 +11,20 @@ This package targets the supported API-key surface:
 - `checkout-sessions`
 - `payouts`
 - `refunds`
-- `reconciliations`
-- `fraud`
-- `compliance`
-- `tax`
+- `receipts`
+- `activity`
 - webhook endpoint management and signature verification
 
 It does not wrap the dashboard/operator control-plane routes such as `/api/identity/*` or `/api/ecosystems/*`.
 
+New integrations should use the namespaced contract shown below. Existing SDK
+integrations remain supported through compatibility shims so current installs do
+not break during the transition.
+
 ## Installation
 
 ```bash
-npm install @soledgic/sdk@0.2.0
+npm install @soledgic/sdk@0.3.0
 ```
 
 ## Quick Start
@@ -32,43 +34,41 @@ import SoledgicClient from '@soledgic/sdk'
 
 const soledgic = new SoledgicClient({
   apiKey: process.env.SOLEDGIC_API_KEY!,
+  baseUrl: process.env.SOLEDGIC_BASE_URL || 'https://api.soledgic.com',
   apiVersion: '2026-03-01',
 })
 
-const participant = await soledgic.createParticipant({
-  participantId: 'creator_456',
+const userWallet = await soledgic.users.upsertWallet({
+  externalUserId: 'user_123',
+  name: 'User 123 wallet',
+})
+
+const creator = await soledgic.creators.upsert({
+  externalCreatorId: 'creator_456',
   userId: '9f9b62d2-2f32-4b20-bc24-1f86b16cb9eb',
   displayName: 'Jane Creator',
   email: 'jane@example.com',
   defaultSplitPercent: 80,
 })
 
-const checkout = await soledgic.createCheckoutSession({
-  participantId: participant.participant.id,
-  amount: 2999,
+const checkout = await soledgic.orders.createCheckout({
+  creatorId: creator.participant.id,
+  externalUserId: 'user_123',
+  externalProductId: 'chapter_001',
+  externalOrderId: 'order_1001',
+  amount: 999,
   currency: 'USD',
-  productName: 'Premium asset pack',
+  productName: 'Chapter 1',
   successUrl: 'https://example.com/success',
   cancelUrl: 'https://example.com/cancel',
 })
 
-const wallets = await soledgic.listWallets({
-  ownerId: participant.participant.id,
-  walletType: 'creator_earnings',
-})
-
-const payout = await soledgic.createPayout({
-  participantId: participant.participant.id,
-  referenceId: 'payout_2026_03_13_001',
-  amount: 1500,
-  payoutMethod: 'bank',
-})
+const activity = await soledgic.activity.listWallet(userWallet.wallet.id, { limit: 10 })
 
 console.log({
   checkoutUrl: checkout.checkoutSession.checkoutUrl,
-  linkedUserId: participant.participant.linkedUserId,
-  availableBalance: wallets.wallets[0]?.availableBalance,
-  payoutTransactionId: payout.payout.transactionId,
+  walletBalance: userWallet.wallet.availableBalance,
+  activityItems: activity.entries.length,
 })
 ```
 
@@ -76,91 +76,70 @@ The wallet API is uniform across integrations, but balances remain scoped.
 Every wallet object belongs to one ledger, one owner, and one wallet type.
 Soledgic does not expose a shared universal wallet balance.
 
-## Public Treasury Methods
+## Public Treasury Namespaces
 
-### Participants
+### Platform and Creators
 
 | Method | Description |
 | --- | --- |
-| `createParticipant(req)` | Create or provision a participant-backed treasury account |
-| `listParticipants()` | List participant balances and linked-user state |
-| `getParticipant(participantId)` | Get one participant with active hold detail |
-| `getParticipantPayoutEligibility(participantId)` | Check payout readiness |
+| `platform.getStatus()` | Read current API and treasury health |
+| `creators.upsert(req)` | Create or update a creator-backed treasury account |
+| `creators.get(creatorId)` | Get one creator with active hold detail |
+| `creators.getPayoutEligibility(creatorId)` | Check payout readiness |
+| `creators.createWallet(req)` | Create a creator earnings wallet when the integration manages wallets directly |
 
-`createParticipant` accepts an optional `userId` so a public participant can be linked to a shared identity record without exposing the operator APIs directly.
+`creators.upsert` accepts an optional `userId` so a public creator can be linked to a shared identity record without exposing the operator APIs directly.
 
 ### Wallets, Transfers, and Holds
 
 | Method | Description |
 | --- | --- |
-| `listWallets(filters?)` | List wallet objects by owner or wallet type |
-| `createWallet(req)` | Create a consumer credit wallet |
-| `getWallet(walletId)` | Fetch a wallet object by wallet id |
-| `getWalletEntries(walletId, opts?)` | List entries for a wallet object |
-| `topUpWallet(req)` | Top up a wallet object |
-| `withdrawFromWallet(req)` | Withdraw from a wallet object |
-| `createTransfer(req)` | Move funds between wallets when transfer is permitted |
-| `listHolds(opts?)` | List held funds |
-| `getHoldSummary()` | Get aggregate held-funds totals |
-| `releaseHold(req)` | Release a hold and optionally execute the transfer |
+| `users.upsertWallet(req)` | Create or update a user wallet |
+| `wallets.list(filters?)` | List wallet objects by owner or wallet type |
+| `wallets.create(req)` | Create a scoped wallet object |
+| `wallets.get(walletId)` | Fetch a wallet object by wallet id |
+| `wallets.listActivity(walletId, opts?)` | List entries for a wallet object |
+| `wallets.topUp(req)` | Top up a wallet object |
+| `wallets.withdraw(req)` | Withdraw from a wallet object |
+| `wallets.transfer(req)` | Move funds between wallets when transfer is permitted |
+| `holds.list(opts?)` | List held funds |
+| `holds.release(req)` | Release a hold and optionally execute the transfer |
 
 Supported wallet types:
 
 - `consumer_credit`: closed-loop platform credits
 - `creator_earnings`: payout-eligible seller or creator proceeds
 
-`createWallet` currently provisions scoped consumer-credit wallets. Creator
+`wallets.create` currently provisions scoped consumer-credit wallets. Creator
 earnings wallets are provisioned through participant and treasury flows.
 
 ### Checkout, Payouts, and Refunds
 
 | Method | Description |
 | --- | --- |
-| `createCheckoutSession(req)` | Create hosted or direct checkout flows |
-| `createPayout(req)` | Create a payout resource |
-| `createRefund(req)` | Create a refund resource |
-| `listRefunds(req?)` | Query refunds, including by `saleReference` |
-
-### Reconciliations
-
-| Method | Description |
-| --- | --- |
-| `listUnmatchedTransactions()` | List ledger transactions that still need reconciliation |
-| `matchTransaction(req)` | Create a reconciliation match |
-| `unmatchTransaction(transactionId)` | Remove a reconciliation match |
-| `createReconciliationSnapshot(req)` | Freeze a reconciliation snapshot for a period or as-of date |
-| `getReconciliationSnapshot(periodId)` | Read the latest snapshot for a period |
-| `autoMatchBankTransaction(bankAggregatorTransactionId)` | Attempt an automatic bank-to-ledger match |
-
-### Fraud, Compliance, and Tax
-
-| Method | Description |
-| --- | --- |
-| `evaluateFraud(req)` | Create a fraud evaluation for a proposed transaction |
-| `listFraudPolicies()` | List active fraud policies |
-| `createFraudPolicy(req)` | Create a fraud policy |
-| `deleteFraudPolicy(policyId)` | Delete a fraud policy |
-| `getComplianceOverview(opts?)` | Summarize ledger-scoped compliance signals |
-| `listComplianceAccessPatterns(opts?)` | Inspect suspicious or high-volume access patterns |
-| `listComplianceFinancialActivity(opts?)` | Summarize payout, sale, refund, and dispute activity |
-| `listComplianceSecuritySummary(opts?)` | Summarize risk-scored security and audit events |
-| `calculateTaxForParticipant(participantId, taxYear?)` | Calculate participant tax totals and shared-profile status |
-| `generateAllTaxDocuments(taxYear?)` | Generate tax documents for the year |
-| `listTaxDocuments(taxYear?)` | List generated tax documents |
-| `getTaxDocument(documentId)` | Read one tax document |
-| `exportTaxDocuments(taxYear?, format?)` | Export tax documents as CSV or JSON |
-| `markTaxDocumentFiled(documentId)` | Mark a document as filed |
-| `generateTaxSummary(taxYear, participantId?)` | Generate tax summary totals for the year |
+| `orders.createCheckout(req)` | Create hosted or direct checkout flows for an order |
+| `purchases.create(req)` | Create a purchase checkout flow |
+| `payouts.request(req)` | Create a payout request |
+| `payouts.getEligibility(creatorId)` | Check creator payout readiness |
+| `refunds.request(req)` | Request a refund through Soledgic |
+| `refunds.list(req?)` | Query refunds, including by `saleReference` |
+| `reversals.create(req)` | Create an accounting reversal |
+| `receipts.upload(req)` | Attach a receipt to a transaction |
+| `activity.listWallet(walletId, opts?)` | List wallet activity for a user-facing activity feed |
+| `activity.listRefunds(req?)` | List refund activity |
 
 ### Webhooks
 
 | Method | Description |
 | --- | --- |
-| `listWebhookEndpoints()` | List configured webhook endpoints |
-| `getWebhookDeliveries(endpointId?, limit?)` | Inspect recent deliveries |
-| `rotateWebhookSecret(endpointId)` | Rotate an endpoint secret |
-| `verifyWebhookSignature(...)` | Verify `X-Soledgic-Signature` |
-| `parseWebhookEvent(payload)` | Parse a webhook payload into an event object |
+| `webhooks.listEndpoints()` | List configured webhook endpoints |
+| `webhooks.createEndpoint(config)` | Create a webhook endpoint |
+| `webhooks.updateEndpoint(endpointId, updates)` | Update a webhook endpoint |
+| `webhooks.deleteEndpoint(endpointId)` | Delete a webhook endpoint |
+| `webhooks.listDeliveries(endpointId?, limit?)` | Inspect recent deliveries |
+| `webhooks.rotateSecret(endpointId)` | Rotate an endpoint secret |
+| `webhooks.verifySignature(...)` | Verify `X-Soledgic-Signature` |
+| `webhooks.parseEvent(payload)` | Parse a webhook payload into an event object |
 
 ## Replay Safety
 
@@ -178,7 +157,7 @@ If your integration retries requests or replays processor events, treat `referen
 import { SoledgicError } from '@soledgic/sdk'
 
 try {
-  await soledgic.createPayout({
+  await soledgic.payouts.request({
     participantId: 'creator_456',
     referenceId: 'payout_retry_safe_001',
     amount: 999999,
@@ -195,6 +174,10 @@ try {
 
 The SDK surfaces structured `error_code` values from the API when they are present. Use those codes for client logic instead of matching on human-readable messages.
 
+## Release Notes
+
+- `0.3.0` adds the namespaced SDK contract while keeping top-level compatibility shims for existing integrations.
+
 ## Security Boundary
 
 This SDK is intentionally limited to the public integration contract:
@@ -207,6 +190,7 @@ It does not authenticate end-user dashboard sessions, and it does not expose the
 - shared identity profiles
 - participant identity linking and unlinking
 - ecosystem management
+- risk, compliance, reconciliation, and tax operations
 - internal fixture cleanup
 
 Those flows are documented in [docs/OPERATOR_CONTROL_PLANE.md](../../docs/OPERATOR_CONTROL_PLANE.md).

package/dist/index.d.mts

@@ -511,17 +511,64 @@ interface CreateRefundRequest {
     idempotencyKey?: string;
     metadata?: Record<string, unknown>;
 }
-interface SendBreachAlertRequest {
-    cashBalance: number;
-    pendingTotal: number;
-    shortfall?: number;
-    coverageRatio?: number;
-    triggeredBy: 'project_intent' | 'get_runway' | 'manual';
-    instrumentId?: string;
-    externalRef?: string;
-    projectionsCreated?: number;
-    channel?: 'slack' | 'email' | 'webhook';
+interface UpsertUserWalletRequest {
+    /** Your app's stable user/customer id. */
+    externalUserId: string;
+    /** Optional label for the wallet owner type. Defaults to "user". */
+    ownerType?: string;
+    name?: string;
+    metadata?: Record<string, unknown>;
 }
+interface UpsertCreatorRequest {
+    /** Your app's stable creator/seller id. */
+    externalCreatorId: string;
+    userId?: string;
+    displayName?: string;
+    email?: string;
+    defaultSplitPercent?: number;
+    taxInfo?: ParticipantTaxInfo;
+    payoutPreferences?: ParticipantPayoutPreferences;
+    metadata?: Record<string, unknown>;
+}
+interface CreateCreatorWalletRequest {
+    /** Your app's stable creator/seller id, mapped to a Soledgic participant. */
+    creatorId: string;
+    name?: string;
+    metadata?: Record<string, unknown>;
+}
+type UniversalCheckoutRequest = {
+    /** Your app's stable creator/seller id, mapped to participant_id. */
+    creatorId: string;
+    amount: number;
+    currency?: string;
+    /** Your app's stable product/session id, mapped to product_id. */
+    externalProductId?: string;
+    productName?: string;
+    /** Your app's stable buyer/user id, mapped to customer_id. */
+    externalUserId?: string;
+    customerEmail?: string;
+    /** Your app's stable order/purchase id. Used as idempotency_key when no explicit idempotencyKey is provided. */
+    externalOrderId?: string;
+    metadata?: Record<string, string>;
+} & ({
+    paymentMethodId: string;
+    sourceId?: string;
+    idempotencyKey: string;
+    successUrl?: string;
+    cancelUrl?: string;
+} | {
+    paymentMethodId?: string;
+    sourceId: string;
+    idempotencyKey: string;
+    successUrl?: string;
+    cancelUrl?: string;
+} | {
+    paymentMethodId?: undefined;
+    sourceId?: undefined;
+    successUrl: string;
+    cancelUrl?: string;
+    idempotencyKey?: string;
+});
 interface InvoiceLineItem {
     description: string;
     quantity: number;
@@ -975,18 +1022,6 @@ interface ReceivePaymentResponse {
     transactionId: string;
     amount: number;
 }
-interface SendBreachAlertResponse {
-    success: boolean;
-    message?: string;
-    alertsSent: number;
-    alertsFailed?: number;
-    alertsSkipped?: number;
-    results?: Array<{
-        channel: string;
-        success: boolean;
-        error?: string;
-    }>;
-}
 interface WalletObject {
     id: string;
     object: 'wallet';
@@ -1239,6 +1274,7 @@ declare function mapWebhookDelivery(delivery: any): WebhookDelivery;
 
 declare const DEFAULT_API_VERSION = "2026-03-01";
 declare const DEFAULT_BASE_URL = "https://api.soledgic.com/v1";
+declare function normalizeBaseUrl(input?: string): string;
 declare class Soledgic {
     private _getKey;
     private baseUrl;
@@ -1250,11 +1286,125 @@ declare class Soledgic {
     readonly webhooks: {
         verifySignature: (payload: WebhookPayloadInput, signatureHeader: string, secret: string, options?: VerifyWebhookSignatureOptions) => Promise<boolean>;
         parseEvent: <T = Record<string, unknown>>(payload: WebhookPayloadInput) => ParsedWebhookEvent<T>;
+        listEndpoints: () => Promise<{
+            success: any;
+            data: any;
+        }>;
+        createEndpoint: (config: {
+            url: string;
+            description?: string;
+            events?: string[];
+        }) => Promise<{
+            success: any;
+            data: {
+                secret: any;
+                id: string;
+                url: string;
+                description: string | null;
+                events: string[];
+                isActive: boolean;
+                createdAt: string;
+                secretRotatedAt: string | null;
+            };
+            message: any;
+        }>;
+        updateEndpoint: (endpointId: string, updates: {
+            url?: string;
+            description?: string;
+            events?: string[];
+            isActive?: boolean;
+        }) => Promise<{
+            success: any;
+            data: WebhookEndpoint;
+        }>;
+        deleteEndpoint: (endpointId: string) => Promise<{
+            success: any;
+            message: any;
+        }>;
+        testEndpoint: (endpointId: string) => Promise<{
+            success: any;
+            error: any;
+            data: {
+                delivered: boolean;
+                status: any;
+                responseTimeMs: any;
+            };
+        }>;
+        listDeliveries: (endpointId?: string, limit?: number) => Promise<{
+            success: any;
+            data: any;
+        }>;
+        rotateSecret: (endpointId: string) => Promise<{
+            success: any;
+            data: {
+                secret: any;
+            };
+            message: any;
+        }>;
+    };
+    readonly platform: {
+        getStatus: () => Promise<unknown>;
+    };
+    readonly users: {
+        upsertWallet: (req: UpsertUserWalletRequest) => Promise<CreateWalletResponse>;
+    };
+    readonly creators: {
+        upsert: (req: UpsertCreatorRequest) => Promise<CreateParticipantResponse>;
+        get: (creatorId: string) => Promise<{
+            success: boolean;
+            participant: ParticipantDetail;
+        }>;
+        getPayoutEligibility: (creatorId: string) => Promise<ParticipantPayoutEligibilityResponse>;
+        createWallet: (req: CreateCreatorWalletRequest) => Promise<CreateWalletResponse>;
+    };
+    readonly orders: {
+        createCheckout: (req: UniversalCheckoutRequest) => Promise<CheckoutSessionResourceResponse>;
+    };
+    readonly purchases: {
+        create: (req: UniversalCheckoutRequest) => Promise<CheckoutSessionResourceResponse>;
+    };
+    readonly wallets: {
+        list: (filters?: ListWalletsRequest) => Promise<ListWalletsResponse>;
+        create: (req: CreateWalletRequest) => Promise<CreateWalletResponse>;
+        get: (walletId: string) => Promise<GetWalletResponse>;
+        listActivity: (walletId: string, options?: {
+            limit?: number;
+            offset?: number;
+        }) => Promise<WalletEntriesResponse>;
+        topUp: (req: WalletTopupRequest) => Promise<WalletTopupResponse>;
+        withdraw: (req: WalletWithdrawRequest) => Promise<WalletWithdrawalResponse>;
+        transfer: (req: ParticipantTransferRequest) => Promise<ParticipantTransferResponse>;
+    };
+    readonly payouts: {
+        request: (req: CreatePayoutRequest) => Promise<PayoutResourceResponse>;
+        getEligibility: (creatorId: string) => Promise<ParticipantPayoutEligibilityResponse>;
+    };
+    readonly refunds: {
+        request: (req: CreateRefundRequest) => Promise<RefundResourceResponse>;
+        list: (req?: ListRefundsRequest) => Promise<ListRefundsResponse>;
+    };
+    readonly holds: {
+        list: (options?: HoldQueryOptions) => Promise<HeldFundsResponse>;
+        release: (req: ReleaseHoldRequest) => Promise<ReleaseHoldResponse>;
+    };
+    readonly reversals: {
+        create: (req: ReverseTransactionRequest) => Promise<ReverseResponse>;
+    };
+    readonly receipts: {
+        upload: (req: UploadReceiptRequest) => Promise<UploadReceiptResponse>;
+    };
+    readonly activity: {
+        listWallet: (walletId: string, options?: {
+            limit?: number;
+            offset?: number;
+        }) => Promise<WalletEntriesResponse>;
+        listRefunds: (req?: ListRefundsRequest) => Promise<ListRefundsResponse>;
     };
     private throwTypedError;
     private request;
     private requestGet;
     private requestRaw;
+    private createUniversalCheckout;
     private requestGetRaw;
     private requestDelete;
     recordIncome(req: RecordIncomeRequest): Promise<unknown>;
@@ -1586,7 +1736,6 @@ declare class Soledgic {
     exportReport(req: ExportReportRequest): Promise<ExportReportJsonResponse | ExportReportCsvResponse>;
     uploadReceipt(req: UploadReceiptRequest): Promise<UploadReceiptResponse>;
     receivePayment(req: ReceivePaymentRequest): Promise<ReceivePaymentResponse>;
-    sendBreachAlert(req: SendBreachAlertRequest): Promise<SendBreachAlertResponse>;
     private mapWalletObject;
     listWallets(filters?: ListWalletsRequest): Promise<ListWalletsResponse>;
     createWallet(req: CreateWalletRequest): Promise<CreateWalletResponse>;
@@ -1633,4 +1782,4 @@ declare class Soledgic {
     importBankStatement(req: ImportBankStatementRequest): Promise<any>;
 }
 
-export { type AlertChannel, type AlertConfiguration, type AlertTestResult, type AlertThresholds, type AlertType, AuthenticationError, type AuthorizationDecisionType, type AuthorizationPolicy, type AuthorizationResult, type AutoMatchReconciliationResponse, type BackdatePolicyRequest, type BreachRisk, type CheckoutBreakdown, type CheckoutSessionResourceResponse, type ComplianceAccessPatternsResponse, type ComplianceFinancialActivityResponse, type ComplianceOverviewResponse, type ComplianceSecuritySummaryResponse, ConflictError, type CreateAlertRequest, type CreateBankAccountRequest, type CreateBudgetRequest, type CreateCheckoutSessionRequest, type CreateContractorRequest, type CreateInvoiceRequest, type CreateLedgerRequest, type CreateLedgerResponse, type CreateParticipantRequest, type CreateParticipantResponse, type CreatePayoutRequest, type CreatePeriodRequest, type CreatePolicyRequest, type CreateRecurringRequest, type CreateRefundRequest, type CreateSnapshotRequest, type CreateWalletRequest, type CreateWalletResponse, DEFAULT_API_VERSION, DEFAULT_BASE_URL, type EmailAlertConfig, type ExportReportCsvResponse, type ExportReportJsonResponse, type ExportReportRequest, type ExtractedTerms, type FraudPolicyDeleteResponse, type FraudPolicyListResponse, type FraudPolicyResource, type FraudPolicyResponse, type FrozenStatement, type GetWalletResponse, type HeldFund, type HeldFundsResponse, type HeldFundsSummaryResponse, type HoldQueryOptions, type ImportBankStatementLine, type ImportBankStatementRequest, type InvoiceLineItem, type ListRefundsRequest, type ListRefundsResponse, type ListWalletsRequest, type ListWalletsResponse, NotFoundError, type ObligationItem, type Obligations, type ParsedWebhookEvent, type ParticipantDetail, type ParticipantPayoutEligibilityResponse, type ParticipantPayoutPreferences, type ParticipantSummary, type ParticipantTaxInfo, type ParticipantTransferRequest, type ParticipantTransferResponse, type ParticipantWalletMutationRequest, type PayBillRequest, type PayoutResourceResponse, type Period, type PolicySeverity, type PolicyType, type PolicyViolation, type PreflightAuthorizationRequest, type PreflightAuthorizationResponse, type PreflightResult, type ProjectIntentRequest, type ProjectIntentResponse, type ProjectionMatch, type ReceivePaymentRequest, type ReceivePaymentResponse, type ReconcileMatchRequest, type ReconciliationMatchResponse, type ReconciliationSnapshot, type ReconciliationUnmatchResponse, type RecordAdjustmentRequest, type RecordBillRequest, type RecordContractorPaymentRequest, type RecordExpenseRequest, type RecordIncomeRequest, type RecordInvoicePaymentRequest, type RecordOpeningBalanceRequest, type RecordRefundResponse, type RecordTransferRequest, type RefundResourceResponse, type RefundSummary, type RegisterInstrumentRequest, type RegisterInstrumentResponse, type ReleaseHoldRequest, type ReleaseHoldResponse, type ReverseResponse, type ReverseTransactionRequest, type RiskEvaluationRequest, type RiskEvaluationResponse, type SendBreachAlertRequest, type SendBreachAlertResponse, type SlackAlertConfig, Soledgic, type SoledgicConfig, SoledgicError, type SubmitTaxInfoRequest, type TaxCalculationResponse, type TaxDocumentGenerationResponse, type TaxDocumentResponse, type TaxDocumentsResponse, type TaxSummaryResponse, type UnmatchedTransactionsResponse, type UpdateAlertRequest, type UploadReceiptRequest, type UploadReceiptResponse, ValidationError, type VerifyWebhookSignatureOptions, type WalletEntriesResponse, type WalletHistoryEntry, type WalletObject, type WalletTopupRequest, type WalletTopupResponse, type WalletWithdrawRequest, type WalletWithdrawalResponse, type WebhookDelivery, type WebhookEndpoint, type WebhookEndpointSecretResult, type WebhookPayloadInput, Soledgic as default, hmacHex, isArrayBufferView, mapWebhookDelivery, mapWebhookEndpoint, parseWebhookEvent, parseWebhookSignatureHeader, resolveWebhookEndpointUrl, timingSafeEqual, verifyWebhookSignature, webhookPayloadToString };
+export { type AlertChannel, type AlertConfiguration, type AlertTestResult, type AlertThresholds, type AlertType, AuthenticationError, type AuthorizationDecisionType, type AuthorizationPolicy, type AuthorizationResult, type AutoMatchReconciliationResponse, type BackdatePolicyRequest, type BreachRisk, type CheckoutBreakdown, type CheckoutSessionResourceResponse, type ComplianceAccessPatternsResponse, type ComplianceFinancialActivityResponse, type ComplianceOverviewResponse, type ComplianceSecuritySummaryResponse, ConflictError, type CreateAlertRequest, type CreateBankAccountRequest, type CreateBudgetRequest, type CreateCheckoutSessionRequest, type CreateContractorRequest, type CreateCreatorWalletRequest, type CreateInvoiceRequest, type CreateLedgerRequest, type CreateLedgerResponse, type CreateParticipantRequest, type CreateParticipantResponse, type CreatePayoutRequest, type CreatePeriodRequest, type CreatePolicyRequest, type CreateRecurringRequest, type CreateRefundRequest, type CreateSnapshotRequest, type CreateWalletRequest, type CreateWalletResponse, DEFAULT_API_VERSION, DEFAULT_BASE_URL, type EmailAlertConfig, type ExportReportCsvResponse, type ExportReportJsonResponse, type ExportReportRequest, type ExtractedTerms, type FraudPolicyDeleteResponse, type FraudPolicyListResponse, type FraudPolicyResource, type FraudPolicyResponse, type FrozenStatement, type GetWalletResponse, type HeldFund, type HeldFundsResponse, type HeldFundsSummaryResponse, type HoldQueryOptions, type ImportBankStatementLine, type ImportBankStatementRequest, type InvoiceLineItem, type ListRefundsRequest, type ListRefundsResponse, type ListWalletsRequest, type ListWalletsResponse, NotFoundError, type ObligationItem, type Obligations, type ParsedWebhookEvent, type ParticipantDetail, type ParticipantPayoutEligibilityResponse, type ParticipantPayoutPreferences, type ParticipantSummary, type ParticipantTaxInfo, type ParticipantTransferRequest, type ParticipantTransferResponse, type ParticipantWalletMutationRequest, type PayBillRequest, type PayoutResourceResponse, type Period, type PolicySeverity, type PolicyType, type PolicyViolation, type PreflightAuthorizationRequest, type PreflightAuthorizationResponse, type PreflightResult, type ProjectIntentRequest, type ProjectIntentResponse, type ProjectionMatch, type ReceivePaymentRequest, type ReceivePaymentResponse, type ReconcileMatchRequest, type ReconciliationMatchResponse, type ReconciliationSnapshot, type ReconciliationUnmatchResponse, type RecordAdjustmentRequest, type RecordBillRequest, type RecordContractorPaymentRequest, type RecordExpenseRequest, type RecordIncomeRequest, type RecordInvoicePaymentRequest, type RecordOpeningBalanceRequest, type RecordRefundResponse, type RecordTransferRequest, type RefundResourceResponse, type RefundSummary, type RegisterInstrumentRequest, type RegisterInstrumentResponse, type ReleaseHoldRequest, type ReleaseHoldResponse, type ReverseResponse, type ReverseTransactionRequest, type RiskEvaluationRequest, type RiskEvaluationResponse, type SlackAlertConfig, Soledgic, type SoledgicConfig, SoledgicError, type SubmitTaxInfoRequest, type TaxCalculationResponse, type TaxDocumentGenerationResponse, type TaxDocumentResponse, type TaxDocumentsResponse, type TaxSummaryResponse, type UniversalCheckoutRequest, type UnmatchedTransactionsResponse, type UpdateAlertRequest, type UploadReceiptRequest, type UploadReceiptResponse, type UpsertCreatorRequest, type UpsertUserWalletRequest, ValidationError, type VerifyWebhookSignatureOptions, type WalletEntriesResponse, type WalletHistoryEntry, type WalletObject, type WalletTopupRequest, type WalletTopupResponse, type WalletWithdrawRequest, type WalletWithdrawalResponse, type WebhookDelivery, type WebhookEndpoint, type WebhookEndpointSecretResult, type WebhookPayloadInput, Soledgic as default, hmacHex, isArrayBufferView, mapWebhookDelivery, mapWebhookEndpoint, normalizeBaseUrl, parseWebhookEvent, parseWebhookSignatureHeader, resolveWebhookEndpointUrl, timingSafeEqual, verifyWebhookSignature, webhookPayloadToString };

package/dist/index.d.ts

@@ -511,17 +511,64 @@ interface CreateRefundRequest {
     idempotencyKey?: string;
     metadata?: Record<string, unknown>;
 }
-interface SendBreachAlertRequest {
-    cashBalance: number;
-    pendingTotal: number;
-    shortfall?: number;
-    coverageRatio?: number;
-    triggeredBy: 'project_intent' | 'get_runway' | 'manual';
-    instrumentId?: string;
-    externalRef?: string;
-    projectionsCreated?: number;
-    channel?: 'slack' | 'email' | 'webhook';
+interface UpsertUserWalletRequest {
+    /** Your app's stable user/customer id. */
+    externalUserId: string;
+    /** Optional label for the wallet owner type. Defaults to "user". */
+    ownerType?: string;
+    name?: string;
+    metadata?: Record<string, unknown>;
 }
+interface UpsertCreatorRequest {
+    /** Your app's stable creator/seller id. */
+    externalCreatorId: string;
+    userId?: string;
+    displayName?: string;
+    email?: string;
+    defaultSplitPercent?: number;
+    taxInfo?: ParticipantTaxInfo;
+    payoutPreferences?: ParticipantPayoutPreferences;
+    metadata?: Record<string, unknown>;
+}
+interface CreateCreatorWalletRequest {
+    /** Your app's stable creator/seller id, mapped to a Soledgic participant. */
+    creatorId: string;
+    name?: string;
+    metadata?: Record<string, unknown>;
+}
+type UniversalCheckoutRequest = {
+    /** Your app's stable creator/seller id, mapped to participant_id. */
+    creatorId: string;
+    amount: number;
+    currency?: string;
+    /** Your app's stable product/session id, mapped to product_id. */
+    externalProductId?: string;
+    productName?: string;
+    /** Your app's stable buyer/user id, mapped to customer_id. */
+    externalUserId?: string;
+    customerEmail?: string;
+    /** Your app's stable order/purchase id. Used as idempotency_key when no explicit idempotencyKey is provided. */
+    externalOrderId?: string;
+    metadata?: Record<string, string>;
+} & ({
+    paymentMethodId: string;
+    sourceId?: string;
+    idempotencyKey: string;
+    successUrl?: string;
+    cancelUrl?: string;
+} | {
+    paymentMethodId?: string;
+    sourceId: string;
+    idempotencyKey: string;
+    successUrl?: string;
+    cancelUrl?: string;
+} | {
+    paymentMethodId?: undefined;
+    sourceId?: undefined;
+    successUrl: string;
+    cancelUrl?: string;
+    idempotencyKey?: string;
+});
 interface InvoiceLineItem {
     description: string;
     quantity: number;
@@ -975,18 +1022,6 @@ interface ReceivePaymentResponse {
     transactionId: string;
     amount: number;
 }
-interface SendBreachAlertResponse {
-    success: boolean;
-    message?: string;
-    alertsSent: number;
-    alertsFailed?: number;
-    alertsSkipped?: number;
-    results?: Array<{
-        channel: string;
-        success: boolean;
-        error?: string;
-    }>;
-}
 interface WalletObject {
     id: string;
     object: 'wallet';
@@ -1239,6 +1274,7 @@ declare function mapWebhookDelivery(delivery: any): WebhookDelivery;
 
 declare const DEFAULT_API_VERSION = "2026-03-01";
 declare const DEFAULT_BASE_URL = "https://api.soledgic.com/v1";
+declare function normalizeBaseUrl(input?: string): string;
 declare class Soledgic {
     private _getKey;
     private baseUrl;
@@ -1250,11 +1286,125 @@ declare class Soledgic {
     readonly webhooks: {
         verifySignature: (payload: WebhookPayloadInput, signatureHeader: string, secret: string, options?: VerifyWebhookSignatureOptions) => Promise<boolean>;
         parseEvent: <T = Record<string, unknown>>(payload: WebhookPayloadInput) => ParsedWebhookEvent<T>;
+        listEndpoints: () => Promise<{
+            success: any;
+            data: any;
+        }>;
+        createEndpoint: (config: {
+            url: string;
+            description?: string;
+            events?: string[];
+        }) => Promise<{
+            success: any;
+            data: {
+                secret: any;
+                id: string;
+                url: string;
+                description: string | null;
+                events: string[];
+                isActive: boolean;
+                createdAt: string;
+                secretRotatedAt: string | null;
+            };
+            message: any;
+        }>;
+        updateEndpoint: (endpointId: string, updates: {
+            url?: string;
+            description?: string;
+            events?: string[];
+            isActive?: boolean;
+        }) => Promise<{
+            success: any;
+            data: WebhookEndpoint;
+        }>;
+        deleteEndpoint: (endpointId: string) => Promise<{
+            success: any;
+            message: any;
+        }>;
+        testEndpoint: (endpointId: string) => Promise<{
+            success: any;
+            error: any;
+            data: {
+                delivered: boolean;
+                status: any;
+                responseTimeMs: any;
+            };
+        }>;
+        listDeliveries: (endpointId?: string, limit?: number) => Promise<{
+            success: any;
+            data: any;
+        }>;
+        rotateSecret: (endpointId: string) => Promise<{
+            success: any;
+            data: {
+                secret: any;
+            };
+            message: any;
+        }>;
+    };
+    readonly platform: {
+        getStatus: () => Promise<unknown>;
+    };
+    readonly users: {
+        upsertWallet: (req: UpsertUserWalletRequest) => Promise<CreateWalletResponse>;
+    };
+    readonly creators: {
+        upsert: (req: UpsertCreatorRequest) => Promise<CreateParticipantResponse>;
+        get: (creatorId: string) => Promise<{
+            success: boolean;
+            participant: ParticipantDetail;
+        }>;
+        getPayoutEligibility: (creatorId: string) => Promise<ParticipantPayoutEligibilityResponse>;
+        createWallet: (req: CreateCreatorWalletRequest) => Promise<CreateWalletResponse>;
+    };
+    readonly orders: {
+        createCheckout: (req: UniversalCheckoutRequest) => Promise<CheckoutSessionResourceResponse>;
+    };
+    readonly purchases: {
+        create: (req: UniversalCheckoutRequest) => Promise<CheckoutSessionResourceResponse>;
+    };
+    readonly wallets: {
+        list: (filters?: ListWalletsRequest) => Promise<ListWalletsResponse>;
+        create: (req: CreateWalletRequest) => Promise<CreateWalletResponse>;
+        get: (walletId: string) => Promise<GetWalletResponse>;
+        listActivity: (walletId: string, options?: {
+            limit?: number;
+            offset?: number;
+        }) => Promise<WalletEntriesResponse>;
+        topUp: (req: WalletTopupRequest) => Promise<WalletTopupResponse>;
+        withdraw: (req: WalletWithdrawRequest) => Promise<WalletWithdrawalResponse>;
+        transfer: (req: ParticipantTransferRequest) => Promise<ParticipantTransferResponse>;
+    };
+    readonly payouts: {
+        request: (req: CreatePayoutRequest) => Promise<PayoutResourceResponse>;
+        getEligibility: (creatorId: string) => Promise<ParticipantPayoutEligibilityResponse>;
+    };
+    readonly refunds: {
+        request: (req: CreateRefundRequest) => Promise<RefundResourceResponse>;
+        list: (req?: ListRefundsRequest) => Promise<ListRefundsResponse>;
+    };
+    readonly holds: {
+        list: (options?: HoldQueryOptions) => Promise<HeldFundsResponse>;
+        release: (req: ReleaseHoldRequest) => Promise<ReleaseHoldResponse>;
+    };
+    readonly reversals: {
+        create: (req: ReverseTransactionRequest) => Promise<ReverseResponse>;
+    };
+    readonly receipts: {
+        upload: (req: UploadReceiptRequest) => Promise<UploadReceiptResponse>;
+    };
+    readonly activity: {
+        listWallet: (walletId: string, options?: {
+            limit?: number;
+            offset?: number;
+        }) => Promise<WalletEntriesResponse>;
+        listRefunds: (req?: ListRefundsRequest) => Promise<ListRefundsResponse>;
     };
     private throwTypedError;
     private request;
     private requestGet;
     private requestRaw;
+    private createUniversalCheckout;
     private requestGetRaw;
     private requestDelete;
     recordIncome(req: RecordIncomeRequest): Promise<unknown>;
@@ -1586,7 +1736,6 @@ declare class Soledgic {
     exportReport(req: ExportReportRequest): Promise<ExportReportJsonResponse | ExportReportCsvResponse>;
     uploadReceipt(req: UploadReceiptRequest): Promise<UploadReceiptResponse>;
     receivePayment(req: ReceivePaymentRequest): Promise<ReceivePaymentResponse>;
-    sendBreachAlert(req: SendBreachAlertRequest): Promise<SendBreachAlertResponse>;
     private mapWalletObject;
     listWallets(filters?: ListWalletsRequest): Promise<ListWalletsResponse>;
     createWallet(req: CreateWalletRequest): Promise<CreateWalletResponse>;
@@ -1633,4 +1782,4 @@ declare class Soledgic {
     importBankStatement(req: ImportBankStatementRequest): Promise<any>;
 }
 
-export { type AlertChannel, type AlertConfiguration, type AlertTestResult, type AlertThresholds, type AlertType, AuthenticationError, type AuthorizationDecisionType, type AuthorizationPolicy, type AuthorizationResult, type AutoMatchReconciliationResponse, type BackdatePolicyRequest, type BreachRisk, type CheckoutBreakdown, type CheckoutSessionResourceResponse, type ComplianceAccessPatternsResponse, type ComplianceFinancialActivityResponse, type ComplianceOverviewResponse, type ComplianceSecuritySummaryResponse, ConflictError, type CreateAlertRequest, type CreateBankAccountRequest, type CreateBudgetRequest, type CreateCheckoutSessionRequest, type CreateContractorRequest, type CreateInvoiceRequest, type CreateLedgerRequest, type CreateLedgerResponse, type CreateParticipantRequest, type CreateParticipantResponse, type CreatePayoutRequest, type CreatePeriodRequest, type CreatePolicyRequest, type CreateRecurringRequest, type CreateRefundRequest, type CreateSnapshotRequest, type CreateWalletRequest, type CreateWalletResponse, DEFAULT_API_VERSION, DEFAULT_BASE_URL, type EmailAlertConfig, type ExportReportCsvResponse, type ExportReportJsonResponse, type ExportReportRequest, type ExtractedTerms, type FraudPolicyDeleteResponse, type FraudPolicyListResponse, type FraudPolicyResource, type FraudPolicyResponse, type FrozenStatement, type GetWalletResponse, type HeldFund, type HeldFundsResponse, type HeldFundsSummaryResponse, type HoldQueryOptions, type ImportBankStatementLine, type ImportBankStatementRequest, type InvoiceLineItem, type ListRefundsRequest, type ListRefundsResponse, type ListWalletsRequest, type ListWalletsResponse, NotFoundError, type ObligationItem, type Obligations, type ParsedWebhookEvent, type ParticipantDetail, type ParticipantPayoutEligibilityResponse, type ParticipantPayoutPreferences, type ParticipantSummary, type ParticipantTaxInfo, type ParticipantTransferRequest, type ParticipantTransferResponse, type ParticipantWalletMutationRequest, type PayBillRequest, type PayoutResourceResponse, type Period, type PolicySeverity, type PolicyType, type PolicyViolation, type PreflightAuthorizationRequest, type PreflightAuthorizationResponse, type PreflightResult, type ProjectIntentRequest, type ProjectIntentResponse, type ProjectionMatch, type ReceivePaymentRequest, type ReceivePaymentResponse, type ReconcileMatchRequest, type ReconciliationMatchResponse, type ReconciliationSnapshot, type ReconciliationUnmatchResponse, type RecordAdjustmentRequest, type RecordBillRequest, type RecordContractorPaymentRequest, type RecordExpenseRequest, type RecordIncomeRequest, type RecordInvoicePaymentRequest, type RecordOpeningBalanceRequest, type RecordRefundResponse, type RecordTransferRequest, type RefundResourceResponse, type RefundSummary, type RegisterInstrumentRequest, type RegisterInstrumentResponse, type ReleaseHoldRequest, type ReleaseHoldResponse, type ReverseResponse, type ReverseTransactionRequest, type RiskEvaluationRequest, type RiskEvaluationResponse, type SendBreachAlertRequest, type SendBreachAlertResponse, type SlackAlertConfig, Soledgic, type SoledgicConfig, SoledgicError, type SubmitTaxInfoRequest, type TaxCalculationResponse, type TaxDocumentGenerationResponse, type TaxDocumentResponse, type TaxDocumentsResponse, type TaxSummaryResponse, type UnmatchedTransactionsResponse, type UpdateAlertRequest, type UploadReceiptRequest, type UploadReceiptResponse, ValidationError, type VerifyWebhookSignatureOptions, type WalletEntriesResponse, type WalletHistoryEntry, type WalletObject, type WalletTopupRequest, type WalletTopupResponse, type WalletWithdrawRequest, type WalletWithdrawalResponse, type WebhookDelivery, type WebhookEndpoint, type WebhookEndpointSecretResult, type WebhookPayloadInput, Soledgic as default, hmacHex, isArrayBufferView, mapWebhookDelivery, mapWebhookEndpoint, parseWebhookEvent, parseWebhookSignatureHeader, resolveWebhookEndpointUrl, timingSafeEqual, verifyWebhookSignature, webhookPayloadToString };
+export { type AlertChannel, type AlertConfiguration, type AlertTestResult, type AlertThresholds, type AlertType, AuthenticationError, type AuthorizationDecisionType, type AuthorizationPolicy, type AuthorizationResult, type AutoMatchReconciliationResponse, type BackdatePolicyRequest, type BreachRisk, type CheckoutBreakdown, type CheckoutSessionResourceResponse, type ComplianceAccessPatternsResponse, type ComplianceFinancialActivityResponse, type ComplianceOverviewResponse, type ComplianceSecuritySummaryResponse, ConflictError, type CreateAlertRequest, type CreateBankAccountRequest, type CreateBudgetRequest, type CreateCheckoutSessionRequest, type CreateContractorRequest, type CreateCreatorWalletRequest, type CreateInvoiceRequest, type CreateLedgerRequest, type CreateLedgerResponse, type CreateParticipantRequest, type CreateParticipantResponse, type CreatePayoutRequest, type CreatePeriodRequest, type CreatePolicyRequest, type CreateRecurringRequest, type CreateRefundRequest, type CreateSnapshotRequest, type CreateWalletRequest, type CreateWalletResponse, DEFAULT_API_VERSION, DEFAULT_BASE_URL, type EmailAlertConfig, type ExportReportCsvResponse, type ExportReportJsonResponse, type ExportReportRequest, type ExtractedTerms, type FraudPolicyDeleteResponse, type FraudPolicyListResponse, type FraudPolicyResource, type FraudPolicyResponse, type FrozenStatement, type GetWalletResponse, type HeldFund, type HeldFundsResponse, type HeldFundsSummaryResponse, type HoldQueryOptions, type ImportBankStatementLine, type ImportBankStatementRequest, type InvoiceLineItem, type ListRefundsRequest, type ListRefundsResponse, type ListWalletsRequest, type ListWalletsResponse, NotFoundError, type ObligationItem, type Obligations, type ParsedWebhookEvent, type ParticipantDetail, type ParticipantPayoutEligibilityResponse, type ParticipantPayoutPreferences, type ParticipantSummary, type ParticipantTaxInfo, type ParticipantTransferRequest, type ParticipantTransferResponse, type ParticipantWalletMutationRequest, type PayBillRequest, type PayoutResourceResponse, type Period, type PolicySeverity, type PolicyType, type PolicyViolation, type PreflightAuthorizationRequest, type PreflightAuthorizationResponse, type PreflightResult, type ProjectIntentRequest, type ProjectIntentResponse, type ProjectionMatch, type ReceivePaymentRequest, type ReceivePaymentResponse, type ReconcileMatchRequest, type ReconciliationMatchResponse, type ReconciliationSnapshot, type ReconciliationUnmatchResponse, type RecordAdjustmentRequest, type RecordBillRequest, type RecordContractorPaymentRequest, type RecordExpenseRequest, type RecordIncomeRequest, type RecordInvoicePaymentRequest, type RecordOpeningBalanceRequest, type RecordRefundResponse, type RecordTransferRequest, type RefundResourceResponse, type RefundSummary, type RegisterInstrumentRequest, type RegisterInstrumentResponse, type ReleaseHoldRequest, type ReleaseHoldResponse, type ReverseResponse, type ReverseTransactionRequest, type RiskEvaluationRequest, type RiskEvaluationResponse, type SlackAlertConfig, Soledgic, type SoledgicConfig, SoledgicError, type SubmitTaxInfoRequest, type TaxCalculationResponse, type TaxDocumentGenerationResponse, type TaxDocumentResponse, type TaxDocumentsResponse, type TaxSummaryResponse, type UniversalCheckoutRequest, type UnmatchedTransactionsResponse, type UpdateAlertRequest, type UploadReceiptRequest, type UploadReceiptResponse, type UpsertCreatorRequest, type UpsertUserWalletRequest, ValidationError, type VerifyWebhookSignatureOptions, type WalletEntriesResponse, type WalletHistoryEntry, type WalletObject, type WalletTopupRequest, type WalletTopupResponse, type WalletWithdrawRequest, type WalletWithdrawalResponse, type WebhookDelivery, type WebhookEndpoint, type WebhookEndpointSecretResult, type WebhookPayloadInput, Soledgic as default, hmacHex, isArrayBufferView, mapWebhookDelivery, mapWebhookEndpoint, normalizeBaseUrl, parseWebhookEvent, parseWebhookSignatureHeader, resolveWebhookEndpointUrl, timingSafeEqual, verifyWebhookSignature, webhookPayloadToString };

package/dist/index.js

@@ -33,6 +33,7 @@ __export(index_exports, {
   isArrayBufferView: () => isArrayBufferView,
   mapWebhookDelivery: () => mapWebhookDelivery,
   mapWebhookEndpoint: () => mapWebhookEndpoint,
+  normalizeBaseUrl: () => normalizeBaseUrl,
   parseWebhookEvent: () => parseWebhookEvent,
   parseWebhookSignatureHeader: () => parseWebhookSignatureHeader,
   resolveWebhookEndpointUrl: () => resolveWebhookEndpointUrl,
@@ -223,11 +224,102 @@ function mapWebhookDelivery(delivery) {
 // src/client.ts
 var DEFAULT_API_VERSION = "2026-03-01";
 var DEFAULT_BASE_URL = "https://api.soledgic.com/v1";
+function normalizeBaseUrl(input) {
+  const raw = (input?.trim() || DEFAULT_BASE_URL).replace(/\/+$/, "");
+  const deduped = raw.replace(/(?:\/v1)+$/, "/v1");
+  if (deduped.endsWith("/v1")) return deduped;
+  return `${deduped}/v1`;
+}
 var Soledgic = class {
   constructor(config) {
     this.webhooks = {
       verifySignature: (payload, signatureHeader, secret, options) => verifyWebhookSignature(payload, signatureHeader, secret, options),
-      parseEvent: (payload) => parseWebhookEvent(payload)
+      parseEvent: (payload) => parseWebhookEvent(payload),
+      listEndpoints: () => this.listWebhookEndpoints(),
+      createEndpoint: (config) => this.createWebhookEndpoint(config),
+      updateEndpoint: (endpointId, updates) => this.updateWebhookEndpoint(endpointId, updates),
+      deleteEndpoint: (endpointId) => this.deleteWebhookEndpoint(endpointId),
+      testEndpoint: (endpointId) => this.testWebhookEndpoint(endpointId),
+      listDeliveries: (endpointId, limit) => this.getWebhookDeliveries(endpointId, limit),
+      rotateSecret: (endpointId) => this.rotateWebhookSecret(endpointId)
+    };
+    this.platform = {
+      getStatus: () => this.getHealthStatus()
+    };
+    this.users = {
+      upsertWallet: (req) => this.createWallet({
+        ownerId: req.externalUserId,
+        ownerType: req.ownerType || "user",
+        walletType: "consumer_credit",
+        name: req.name,
+        metadata: {
+          ...req.metadata,
+          external_user_id: req.externalUserId
+        }
+      })
+    };
+    this.creators = {
+      upsert: (req) => this.createParticipant({
+        participantId: req.externalCreatorId,
+        userId: req.userId,
+        displayName: req.displayName,
+        email: req.email,
+        defaultSplitPercent: req.defaultSplitPercent,
+        taxInfo: req.taxInfo,
+        payoutPreferences: req.payoutPreferences,
+        metadata: {
+          ...req.metadata,
+          external_creator_id: req.externalCreatorId
+        }
+      }),
+      get: (creatorId) => this.getParticipant(creatorId),
+      getPayoutEligibility: (creatorId) => this.getParticipantPayoutEligibility(creatorId),
+      createWallet: (req) => this.createWallet({
+        participantId: req.creatorId,
+        walletType: "creator_earnings",
+        name: req.name,
+        metadata: {
+          ...req.metadata,
+          external_creator_id: req.creatorId
+        }
+      })
+    };
+    this.orders = {
+      createCheckout: (req) => this.createUniversalCheckout(req)
+    };
+    this.purchases = {
+      create: (req) => this.createUniversalCheckout(req)
+    };
+    this.wallets = {
+      list: (filters) => this.listWallets(filters),
+      create: (req) => this.createWallet(req),
+      get: (walletId) => this.getWallet(walletId),
+      listActivity: (walletId, options) => this.getWalletEntries(walletId, options),
+      topUp: (req) => this.topUpWallet(req),
+      withdraw: (req) => this.withdrawFromWallet(req),
+      transfer: (req) => this.createTransfer(req)
+    };
+    this.payouts = {
+      request: (req) => this.createPayout(req),
+      getEligibility: (creatorId) => this.getParticipantPayoutEligibility(creatorId)
+    };
+    this.refunds = {
+      request: (req) => this.createRefund(req),
+      list: (req) => this.listRefunds(req)
+    };
+    this.holds = {
+      list: (options) => this.listHolds(options),
+      release: (req) => this.releaseHold(req)
+    };
+    this.reversals = {
+      create: (req) => this.reverseTransaction(req)
+    };
+    this.receipts = {
+      upload: (req) => this.uploadReceipt(req)
+    };
+    this.activity = {
+      listWallet: (walletId, options) => this.getWalletEntries(walletId, options),
+      listRefunds: (req) => this.listRefunds(req)
     };
     if (!config.apiKey) {
       throw new Error("apiKey is required");
@@ -240,7 +332,7 @@ var Soledgic = class {
     this._destroyKey = () => {
       key = null;
     };
-    this.baseUrl = (config.baseUrl?.trim() || DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.baseUrl = normalizeBaseUrl(config.baseUrl);
     this.timeoutMs = config.timeout ?? 3e4;
     this.apiVersion = (config.apiVersion || "").trim() || DEFAULT_API_VERSION;
   }
@@ -354,6 +446,23 @@ var Soledgic = class {
       clearTimeout(timer);
     }
   }
+  createUniversalCheckout(req) {
+    const metadata = {
+      ...req.metadata,
+      ...req.externalOrderId ? { external_order_id: req.externalOrderId } : {},
+      ...req.externalProductId ? { external_product_id: req.externalProductId } : {},
+      ...req.externalUserId ? { external_user_id: req.externalUserId } : {}
+    };
+    const checkoutReq = {
+      ...req,
+      participantId: req.creatorId,
+      productId: req.externalProductId,
+      customerId: req.externalUserId,
+      idempotencyKey: "idempotencyKey" in req ? req.idempotencyKey || req.externalOrderId : req.externalOrderId,
+      metadata
+    };
+    return this.createCheckoutSession(checkoutReq);
+  }
   async requestGetRaw(endpoint, params) {
     const url = new URL(`${this.baseUrl}/${endpoint}`);
     if (params) {
@@ -1669,32 +1778,6 @@ var Soledgic = class {
       metadata: req.metadata
     });
   }
-  // === BREACH ALERTS ===
-  async sendBreachAlert(req) {
-    const response = await this.request("send-breach-alert", {
-      cash_balance: req.cashBalance,
-      pending_total: req.pendingTotal,
-      shortfall: req.shortfall,
-      coverage_ratio: req.coverageRatio,
-      triggered_by: req.triggeredBy,
-      instrument_id: req.instrumentId,
-      external_ref: req.externalRef,
-      projections_created: req.projectionsCreated,
-      channel: req.channel
-    });
-    return {
-      success: response.success,
-      message: response.message,
-      alertsSent: response.alerts_sent ?? 0,
-      alertsFailed: response.alerts_failed,
-      alertsSkipped: response.alerts_skipped,
-      results: response.results ? response.results.map((r) => ({
-        channel: r.channel,
-        success: r.success,
-        error: r.error
-      })) : void 0
-    };
-  }
   // === WALLETS ===
   mapWalletObject(wallet) {
     return {
@@ -2218,6 +2301,7 @@ var client_default = Soledgic;
   isArrayBufferView,
   mapWebhookDelivery,
   mapWebhookEndpoint,
+  normalizeBaseUrl,
   parseWebhookEvent,
   parseWebhookSignatureHeader,
   resolveWebhookEndpointUrl,

package/dist/index.mjs

@@ -179,11 +179,102 @@ function mapWebhookDelivery(delivery) {
 // src/client.ts
 var DEFAULT_API_VERSION = "2026-03-01";
 var DEFAULT_BASE_URL = "https://api.soledgic.com/v1";
+function normalizeBaseUrl(input) {
+  const raw = (input?.trim() || DEFAULT_BASE_URL).replace(/\/+$/, "");
+  const deduped = raw.replace(/(?:\/v1)+$/, "/v1");
+  if (deduped.endsWith("/v1")) return deduped;
+  return `${deduped}/v1`;
+}
 var Soledgic = class {
   constructor(config) {
     this.webhooks = {
       verifySignature: (payload, signatureHeader, secret, options) => verifyWebhookSignature(payload, signatureHeader, secret, options),
-      parseEvent: (payload) => parseWebhookEvent(payload)
+      parseEvent: (payload) => parseWebhookEvent(payload),
+      listEndpoints: () => this.listWebhookEndpoints(),
+      createEndpoint: (config) => this.createWebhookEndpoint(config),
+      updateEndpoint: (endpointId, updates) => this.updateWebhookEndpoint(endpointId, updates),
+      deleteEndpoint: (endpointId) => this.deleteWebhookEndpoint(endpointId),
+      testEndpoint: (endpointId) => this.testWebhookEndpoint(endpointId),
+      listDeliveries: (endpointId, limit) => this.getWebhookDeliveries(endpointId, limit),
+      rotateSecret: (endpointId) => this.rotateWebhookSecret(endpointId)
+    };
+    this.platform = {
+      getStatus: () => this.getHealthStatus()
+    };
+    this.users = {
+      upsertWallet: (req) => this.createWallet({
+        ownerId: req.externalUserId,
+        ownerType: req.ownerType || "user",
+        walletType: "consumer_credit",
+        name: req.name,
+        metadata: {
+          ...req.metadata,
+          external_user_id: req.externalUserId
+        }
+      })
+    };
+    this.creators = {
+      upsert: (req) => this.createParticipant({
+        participantId: req.externalCreatorId,
+        userId: req.userId,
+        displayName: req.displayName,
+        email: req.email,
+        defaultSplitPercent: req.defaultSplitPercent,
+        taxInfo: req.taxInfo,
+        payoutPreferences: req.payoutPreferences,
+        metadata: {
+          ...req.metadata,
+          external_creator_id: req.externalCreatorId
+        }
+      }),
+      get: (creatorId) => this.getParticipant(creatorId),
+      getPayoutEligibility: (creatorId) => this.getParticipantPayoutEligibility(creatorId),
+      createWallet: (req) => this.createWallet({
+        participantId: req.creatorId,
+        walletType: "creator_earnings",
+        name: req.name,
+        metadata: {
+          ...req.metadata,
+          external_creator_id: req.creatorId
+        }
+      })
+    };
+    this.orders = {
+      createCheckout: (req) => this.createUniversalCheckout(req)
+    };
+    this.purchases = {
+      create: (req) => this.createUniversalCheckout(req)
+    };
+    this.wallets = {
+      list: (filters) => this.listWallets(filters),
+      create: (req) => this.createWallet(req),
+      get: (walletId) => this.getWallet(walletId),
+      listActivity: (walletId, options) => this.getWalletEntries(walletId, options),
+      topUp: (req) => this.topUpWallet(req),
+      withdraw: (req) => this.withdrawFromWallet(req),
+      transfer: (req) => this.createTransfer(req)
+    };
+    this.payouts = {
+      request: (req) => this.createPayout(req),
+      getEligibility: (creatorId) => this.getParticipantPayoutEligibility(creatorId)
+    };
+    this.refunds = {
+      request: (req) => this.createRefund(req),
+      list: (req) => this.listRefunds(req)
+    };
+    this.holds = {
+      list: (options) => this.listHolds(options),
+      release: (req) => this.releaseHold(req)
+    };
+    this.reversals = {
+      create: (req) => this.reverseTransaction(req)
+    };
+    this.receipts = {
+      upload: (req) => this.uploadReceipt(req)
+    };
+    this.activity = {
+      listWallet: (walletId, options) => this.getWalletEntries(walletId, options),
+      listRefunds: (req) => this.listRefunds(req)
     };
     if (!config.apiKey) {
       throw new Error("apiKey is required");
@@ -196,7 +287,7 @@ var Soledgic = class {
     this._destroyKey = () => {
       key = null;
     };
-    this.baseUrl = (config.baseUrl?.trim() || DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.baseUrl = normalizeBaseUrl(config.baseUrl);
     this.timeoutMs = config.timeout ?? 3e4;
     this.apiVersion = (config.apiVersion || "").trim() || DEFAULT_API_VERSION;
   }
@@ -310,6 +401,23 @@ var Soledgic = class {
       clearTimeout(timer);
     }
   }
+  createUniversalCheckout(req) {
+    const metadata = {
+      ...req.metadata,
+      ...req.externalOrderId ? { external_order_id: req.externalOrderId } : {},
+      ...req.externalProductId ? { external_product_id: req.externalProductId } : {},
+      ...req.externalUserId ? { external_user_id: req.externalUserId } : {}
+    };
+    const checkoutReq = {
+      ...req,
+      participantId: req.creatorId,
+      productId: req.externalProductId,
+      customerId: req.externalUserId,
+      idempotencyKey: "idempotencyKey" in req ? req.idempotencyKey || req.externalOrderId : req.externalOrderId,
+      metadata
+    };
+    return this.createCheckoutSession(checkoutReq);
+  }
   async requestGetRaw(endpoint, params) {
     const url = new URL(`${this.baseUrl}/${endpoint}`);
     if (params) {
@@ -1625,32 +1733,6 @@ var Soledgic = class {
       metadata: req.metadata
     });
   }
-  // === BREACH ALERTS ===
-  async sendBreachAlert(req) {
-    const response = await this.request("send-breach-alert", {
-      cash_balance: req.cashBalance,
-      pending_total: req.pendingTotal,
-      shortfall: req.shortfall,
-      coverage_ratio: req.coverageRatio,
-      triggered_by: req.triggeredBy,
-      instrument_id: req.instrumentId,
-      external_ref: req.externalRef,
-      projections_created: req.projectionsCreated,
-      channel: req.channel
-    });
-    return {
-      success: response.success,
-      message: response.message,
-      alertsSent: response.alerts_sent ?? 0,
-      alertsFailed: response.alerts_failed,
-      alertsSkipped: response.alerts_skipped,
-      results: response.results ? response.results.map((r) => ({
-        channel: r.channel,
-        success: r.success,
-        error: r.error
-      })) : void 0
-    };
-  }
   // === WALLETS ===
   mapWalletObject(wallet) {
     return {
@@ -2174,6 +2256,7 @@ export {
   isArrayBufferView,
   mapWebhookDelivery,
   mapWebhookEndpoint,
+  normalizeBaseUrl,
   parseWebhookEvent,
   parseWebhookSignatureHeader,
   resolveWebhookEndpointUrl,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@soledgic/sdk",
-  "version": "0.2.2",
-  "description": "Financial infrastructure for digital platforms — ledger API with wallets, splits, and treasury controls",
+  "version": "0.3.0",
+  "description": "Wallet-first payment infrastructure API for marketplaces, creator platforms, and closed-loop app economies",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -33,7 +33,8 @@
     "build": "tsup src/index.ts --format cjs,esm --dts",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "test": "vitest run",
-    "prepublishOnly": "npm run build"
+    "audit:package": "node ../../scripts/audit-sdk-package.mjs",
+    "prepublishOnly": "npm run build && npm run audit:package"
   },
   "keywords": [
     "accounting",