@resvary/sdk 0.8.0 → 1.0.0-rc.2

package/dist/admin/index.d.ts

@@ -0,0 +1,3 @@
+export { decodeAdminCursor, encodeAdminCursor, normalizeAdminPage, type AdminAuditQuery, type AdminCursorValue, type AdminCustomerDetail, type AdminCustomerQuery, type AdminCustomerSummary, type AdminOverview, type AdminPage, type AdminPageInput, type AdminQueryStore, type AdminUsageEvidence, type AuditItem, type AuditItemKind, type OperatorAction, type OperatorActionStatus, type OperatorActionType, } from './types.js';
+export { OperatorService, type OperatorAdjustInput, type OperatorExpireOverdueInput, type OperatorGrantInput, type OperatorRequeueInput, type OperatorServiceConfig, } from './service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC"}

package/dist/admin/index.js

@@ -0,0 +1,3 @@
+export { decodeAdminCursor, encodeAdminCursor, normalizeAdminPage, } from './types.js';
+export { OperatorService, } from './service.js';
+//# sourceMappingURL=index.js.map

package/dist/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GAgBnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,GAMhB,MAAM,cAAc,CAAC"}

package/dist/admin/service.d.ts

@@ -0,0 +1,62 @@
+import type { CreditLedger } from '../credits/ledger.js';
+import type { CreditStore, OutboxDeliveryStore } from '../credits/store.js';
+import type { AdminQueryStore, OperatorAction } from './types.js';
+export interface OperatorServiceConfig {
+    projectId: string;
+    ledger: CreditLedger;
+    adminStore: AdminQueryStore;
+    deliveryStore: CreditStore & OutboxDeliveryStore;
+    now?: () => number;
+}
+interface OperatorCommandBase {
+    actionId: string;
+    reason: string;
+}
+export interface OperatorGrantInput extends OperatorCommandBase {
+    customerId: string;
+    amount: string;
+}
+export interface OperatorAdjustInput extends OperatorCommandBase {
+    customerId: string;
+    amount: string;
+}
+export interface OperatorExpireOverdueInput extends OperatorCommandBase {
+    before?: number;
+}
+export interface OperatorRequeueInput extends OperatorCommandBase {
+    eventId: string;
+}
+export declare class OperatorService {
+    private readonly config;
+    private readonly now;
+    constructor(config: OperatorServiceConfig);
+    grantCredits(input: OperatorGrantInput): Promise<{
+        action: OperatorAction;
+        result: {
+            account: import("../index.js").CreditAccount;
+            grant: import("../index.js").CreditGrant;
+        };
+    }>;
+    adjustCredits(input: OperatorAdjustInput): Promise<{
+        action: OperatorAction;
+        result: {
+            account: import("../index.js").CreditAccount;
+            entry: import("../index.js").LedgerEntry;
+        };
+    }>;
+    expireOverdueReservations(input: OperatorExpireOverdueInput): Promise<{
+        action: OperatorAction;
+        result: import("../index.js").CreditReservation[];
+    }>;
+    requeueDeadLetter(input: OperatorRequeueInput): Promise<{
+        action: OperatorAction;
+        result: import("../index.js").CreditOutboxEvent<unknown> | undefined;
+    }>;
+    private execute;
+    private appendOutcome;
+    private assertSameCommand;
+    private idempotencyKey;
+    private metadata;
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/admin/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/admin/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAGf,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,eAAe,CAAC;IAC5B,aAAa,EAAE,WAAW,GAAG,mBAAmB,CAAC;IACjD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEN,MAAM,EAAE,qBAAqB;IAQ1D,YAAY,CAAC,KAAK,EAAE,kBAAkB;gBAkEjB,cAAc;;;;;;IApDnC,aAAa,CAAC,KAAK,EAAE,mBAAmB;gBAoDnB,cAAc;;;;;;IAxCnC,yBAAyB,CAAC,KAAK,EAAE,0BAA0B;gBAwCtC,cAAc;;;IA3B7B,iBAAiB,CAAC,KAAK,EAAE,oBAAoB;gBA2B9B,cAAc;;;YANrB,OAAO;YA8DP,aAAa;IA8B3B,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,QAAQ;CAOjB"}

package/dist/admin/service.js

@@ -0,0 +1,150 @@
+import { toCreditUnits } from '../credits/amount.js';
+export class OperatorService {
+    config;
+    now;
+    constructor(config) {
+        this.config = config;
+        if (!config.projectId.trim())
+            throw new Error('Operator projectId is required');
+        if (config.ledger.projectId !== config.projectId) {
+            throw new Error('Operator service and ledger must use the same projectId');
+        }
+        this.now = config.now ?? Date.now;
+    }
+    grantCredits(input) {
+        if (toCreditUnits(input.amount) <= 0n)
+            throw new Error('Operator grant amount must be positive');
+        return this.execute(input, 'credit.grant', 'customer', input.customerId, () => this.config.ledger.grantCredits({
+            customerId: input.customerId,
+            amount: input.amount,
+            source: 'manual',
+            idempotencyKey: this.idempotencyKey(input.actionId),
+            metadata: this.metadata(input),
+        }));
+    }
+    adjustCredits(input) {
+        return this.execute(input, 'credit.adjust', 'customer', input.customerId, () => this.config.ledger.adjustCredits({
+            customerId: input.customerId,
+            amount: input.amount,
+            reason: input.reason,
+            idempotencyKey: this.idempotencyKey(input.actionId),
+            metadata: this.metadata(input),
+        }));
+    }
+    expireOverdueReservations(input) {
+        const currentTime = this.now();
+        const before = input.before ?? currentTime;
+        if (!Number.isSafeInteger(before))
+            throw new Error('Operator expiry time must be an integer');
+        if (before > currentTime)
+            throw new Error('Operator expiry time cannot be in the future');
+        return this.execute(input, 'reservation.expire_overdue', 'project', this.config.projectId, () => this.config.ledger.releaseExpiredReservations({
+            now: before,
+            idempotencyKey: this.idempotencyKey(input.actionId),
+        }));
+    }
+    async requeueDeadLetter(input) {
+        return this.execute(input, 'outbox.requeue', 'outbox_event', input.eventId, async (pendingRecovery) => {
+            const event = await this.config.deliveryStore.getOutboxEvent(input.eventId);
+            if (!event || event.projectId !== this.config.projectId) {
+                throw new Error(`Outbox event not found: ${input.eventId}`);
+            }
+            if (pendingRecovery && event.status === 'pending' && event.attemptCount === 0)
+                return event;
+            if (event.status !== 'dead_letter') {
+                throw new Error(`Outbox event is not dead-lettered: ${input.eventId}`);
+            }
+            await this.config.deliveryStore.requeueOutboxEvent(input.eventId, this.now());
+            return this.config.deliveryStore.getOutboxEvent(input.eventId);
+        });
+    }
+    async execute(input, type, targetType, targetId, operation) {
+        const actionId = requireUuid(input.actionId);
+        const reason = requireText(input.reason, 'reason');
+        const existing = await this.config.adminStore.getOperatorAction(this.config.projectId, actionId);
+        if (existing) {
+            this.assertSameCommand(existing, type, targetType, targetId, reason);
+            if (existing.status === 'succeeded') {
+                return { action: existing, result: existing.result };
+            }
+            if (existing.status === 'failed')
+                throw new Error(existing.error ?? 'Operator action failed');
+        }
+        else {
+            await this.config.adminStore.appendOperatorAction({
+                id: actionId,
+                sequence: 0,
+                projectId: this.config.projectId,
+                type,
+                targetType,
+                targetId,
+                reason,
+                status: 'pending',
+                createdAt: this.now(),
+            });
+        }
+        let result;
+        try {
+            result = await operation(existing?.status === 'pending');
+        }
+        catch (error) {
+            await this.appendOutcome(actionId, type, targetType, targetId, reason, 'failed', undefined, error instanceof Error ? error.message : String(error));
+            throw error;
+        }
+        const action = await this.appendOutcome(actionId, type, targetType, targetId, reason, 'succeeded', result);
+        return { action, result };
+    }
+    async appendOutcome(id, type, targetType, targetId, reason, status, result, error) {
+        const pending = await this.config.adminStore.getOperatorAction(this.config.projectId, id);
+        if (pending?.status === 'succeeded')
+            return pending;
+        const action = {
+            id,
+            sequence: (pending?.sequence ?? 0) + 1,
+            projectId: this.config.projectId,
+            type,
+            targetType,
+            targetId,
+            reason,
+            status,
+            createdAt: pending?.createdAt ?? this.now(),
+            completedAt: this.now(),
+            result,
+            error,
+        };
+        await this.config.adminStore.appendOperatorAction(action);
+        return action;
+    }
+    assertSameCommand(action, type, targetType, targetId, reason) {
+        if (action.type !== type ||
+            action.targetType !== targetType ||
+            action.targetId !== targetId ||
+            action.reason !== reason) {
+            throw new Error(`Operator action id ${action.id} was already used for another command`);
+        }
+    }
+    idempotencyKey(actionId) {
+        return `operator:${this.config.projectId}:${actionId}`;
+    }
+    metadata(input) {
+        return {
+            source: 'operator_console',
+            operatorActionId: input.actionId,
+            reason: input.reason,
+        };
+    }
+}
+function requireText(value, field) {
+    const normalized = value.trim();
+    if (!normalized)
+        throw new Error(`Operator ${field} is required`);
+    return normalized;
+}
+function requireUuid(value) {
+    const actionId = requireText(value, 'actionId');
+    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(actionId)) {
+        throw new Error('Operator actionId must be a UUID');
+    }
+    return actionId;
+}
+//# sourceMappingURL=service.js.map

package/dist/admin/service.js.map

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

package/dist/admin/types.d.ts

@@ -0,0 +1,117 @@
+import type { CreditAccount, CreditGrant, CreditLot, CreditOutboxEvent, CreditReservation, FundingIntent, FundingTransaction, LedgerEntry, PriceVersion, UsageReceipt } from '../credits/types.js';
+export interface AdminPage<T> {
+    items: T[];
+    nextCursor?: string;
+}
+export interface AdminPageInput {
+    cursor?: string;
+    limit?: number;
+}
+export interface AdminOverview {
+    projectId: string;
+    generatedAt: number;
+    postedUnits: string;
+    reservedUnits: string;
+    availableUnits: string;
+    charged24hUnits: string;
+    charged7dUnits: string;
+    charged30dUnits: string;
+    customerCount: number;
+    overdueReservationCount: number;
+    pendingOutboxCount: number;
+    deadLetterCount: number;
+    reconciliationRequiredCount: number;
+    dailyCharges: Array<{
+        day: string;
+        amountUnits: string;
+        receiptCount: number;
+    }>;
+}
+export interface AdminCustomerSummary {
+    account: CreditAccount;
+    receiptCount: number;
+    charged30dUnits: string;
+    openReservationCount: number;
+    lastActivityAt?: number;
+}
+export interface AdminCustomerQuery extends AdminPageInput {
+    projectId: string;
+    search?: string;
+}
+export type AuditItemKind = 'grant' | 'reservation' | 'usage_receipt' | 'ledger_entry' | 'funding_intent' | 'funding_transaction' | 'outbox_event' | 'operator_action';
+export interface AuditItem {
+    id: string;
+    projectId: string;
+    customerId?: string;
+    kind: AuditItemKind;
+    type: string;
+    status?: string;
+    amountUnits?: string;
+    createdAt: number;
+    payload: unknown;
+}
+export interface AdminAuditQuery extends AdminPageInput {
+    projectId: string;
+    customerId?: string;
+    entityId?: string;
+    kind?: AuditItemKind;
+    type?: string;
+    status?: string;
+    from?: number;
+    to?: number;
+}
+export interface AdminCustomerDetail {
+    account: CreditAccount;
+    grants: CreditGrant[];
+    lots: CreditLot[];
+    reservations: CreditReservation[];
+    receipts: UsageReceipt[];
+    ledgerEntries: LedgerEntry[];
+    fundingIntents: FundingIntent[];
+    fundingTransactions: FundingTransaction[];
+}
+export interface AdminUsageEvidence {
+    receipt: UsageReceipt;
+    reservation?: CreditReservation;
+    price?: PriceVersion;
+    ledgerEntries: LedgerEntry[];
+}
+export type OperatorActionType = 'credit.grant' | 'credit.adjust' | 'reservation.expire_overdue' | 'outbox.requeue';
+export type OperatorActionStatus = 'pending' | 'succeeded' | 'failed';
+export interface OperatorAction {
+    id: string;
+    sequence: number;
+    projectId: string;
+    type: OperatorActionType;
+    targetType: 'customer' | 'project' | 'outbox_event';
+    targetId: string;
+    reason: string;
+    status: OperatorActionStatus;
+    createdAt: number;
+    completedAt?: number;
+    result?: unknown;
+    error?: string;
+}
+export interface AdminQueryStore {
+    getOverview(projectId: string, now?: number): Promise<AdminOverview>;
+    listCustomers(input: AdminCustomerQuery): Promise<AdminPage<AdminCustomerSummary>>;
+    getCustomer(projectId: string, customerId: string): Promise<AdminCustomerDetail | undefined>;
+    listAuditItems(input: AdminAuditQuery): Promise<AdminPage<AuditItem>>;
+    getUsageEvidence(projectId: string, receiptId: string): Promise<AdminUsageEvidence | undefined>;
+    listOverdueReservations(projectId: string, now?: number): Promise<CreditReservation[]>;
+    listDeadLetterEvents(projectId: string): Promise<CreditOutboxEvent[]>;
+    getOperatorAction(projectId: string, id: string): Promise<OperatorAction | undefined>;
+    listOperatorActions(projectId: string, input?: AdminPageInput): Promise<AdminPage<OperatorAction>>;
+    appendOperatorAction(action: OperatorAction): Promise<void>;
+}
+export interface AdminCursorValue {
+    createdAt: number;
+    id: string;
+}
+export declare function normalizeAdminPage(input: AdminPageInput): {
+    limit: number;
+    cursor?: AdminCursorValue;
+};
+export declare function encodeAdminCursor(value: AdminCursorValue): string;
+export declare function decodeAdminCursor(value: string): AdminCursorValue;
+//# sourceMappingURL=types.d.ts.map

package/dist/admin/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/admin/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,YAAY,EACb,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,2BAA2B,EAAE,MAAM,CAAC;IACpC,YAAY,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjF;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,aAAa,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,aAAa,GACb,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,qBAAqB,GACrB,cAAc,GACd,iBAAiB,CAAC;AAEtB,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,kBAAkB,GAC1B,cAAc,GACd,eAAe,GACf,4BAA4B,GAC5B,gBAAgB,CAAC;AAErB,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,kBAAkB,CAAC;IACzB,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,cAAc,CAAC;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACrE,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACnF,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IAC7F,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;IACtE,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;IAChG,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACvF,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACtE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IACtF,mBAAmB,CACjB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC;IACtC,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,CAMA;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAGjE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAajE"}

package/dist/admin/types.js

@@ -0,0 +1,25 @@
+export function normalizeAdminPage(input) {
+    const limit = input.limit ?? 50;
+    if (!Number.isSafeInteger(limit) || limit <= 0 || limit > 100) {
+        throw new Error('Admin page limit must be an integer between 1 and 100');
+    }
+    return { limit, cursor: input.cursor ? decodeAdminCursor(input.cursor) : undefined };
+}
+export function encodeAdminCursor(value) {
+    const encoded = JSON.stringify(value);
+    return Buffer.from(encoded, 'utf8').toString('base64url');
+}
+export function decodeAdminCursor(value) {
+    try {
+        const parsed = JSON.parse(Buffer.from(value, 'base64url').toString('utf8'));
+        const createdAt = parsed.createdAt;
+        if (!Number.isSafeInteger(createdAt) || typeof parsed.id !== 'string' || !parsed.id) {
+            throw new Error('invalid cursor payload');
+        }
+        return { createdAt: createdAt, id: parsed.id };
+    }
+    catch {
+        throw new Error('Invalid admin cursor');
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/admin/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/admin/types.ts"],"names":[],"mappings":"AAoJA,MAAM,UAAU,kBAAkB,CAAC,KAAqB;IAItD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAuB;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CACpB,CAAC;QAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACpF,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,SAAmB,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@resvary/sdk",
-  "version": "0.8.0",
+  "version": "1.0.0-rc.2",
   "description": "Prepaid credits and usage billing SDK for AI products",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,6 +26,10 @@
       "types": "./dist/credits/index.d.ts",
       "import": "./dist/credits/index.js"
     },
+    "./admin": {
+      "types": "./dist/admin/index.d.ts",
+      "import": "./dist/admin/index.js"
+    },
     "./pricing": {
       "types": "./dist/pricing/index.d.ts",
       "import": "./dist/pricing/index.js"
@@ -115,5 +119,5 @@
     "typescript": "^5.6.0",
     "vitest": "^4.1.11"
   },
-  "gitHead": "1372d2c0dcba8ea1cd25736848d5ec22a3e34fbf"
+  "gitHead": "ecd314fbda6d20041dd121dae0f050a92c012b5c"
 }