@goodz-core/sdk 0.1.0

package/dist/core/index.d.ts

@@ -0,0 +1,591 @@
+/**
+ * @goodz-core/sdk — Public API Type Definitions
+ *
+ * Hand-crafted types mirroring GoodZ.Core's tRPC API surface.
+ * These are the source of truth for SDK consumers — they define
+ * the contract between apps and Core.
+ *
+ * Naming convention:
+ *   Input types:  {Namespace}{Method}Input
+ *   Output types: {Namespace}{Method}Output
+ *
+ * @module
+ */
+type SaleType = "direct" | "wholesale" | "retail_resale" | "gacha" | "trade";
+type TransferReason = "purchase" | "gift" | "trade" | "admin_transfer";
+type PurchaseChannel = "web" | "ios" | "android";
+type ZcoinTxType = "DEPOSIT" | "PURCHASE" | "APP_PAYMENT" | "DIRECT_PURCHASE" | "REFUND" | "ADJUSTMENT" | "EXPIRY";
+interface ZcoinGetMyBalanceOutput {
+    balance: number;
+    totalDeposited: number;
+    totalSpent: number;
+    version: number;
+}
+interface ZcoinGetMyHistoryInput {
+    limit?: number;
+    offset?: number;
+    txType?: ZcoinTxType;
+}
+interface ZcoinCommercialTransferInput {
+    /** ID of the card_instance to transfer */
+    instanceId: number;
+    /** Buyer's userId — will be debited Z-coin */
+    buyerUserId: number;
+    /** Seller's userId — must be current owner of the instance */
+    sellerUserId: number;
+    /** Transaction price in Z-coin hundredths (e.g. 1050 = 10.50 Z-coin) */
+    priceZcoin: number;
+    /** Type of sale — determines fee rules */
+    saleType: SaleType;
+    /** Idempotency key (e.g., Commerce order ID, Exchange trade ID) */
+    referenceId: string;
+    /** OAuth APP client ID of the calling application */
+    appClientId: string;
+    /** Human-readable description of the transaction */
+    description?: string;
+    /** Optional listing ID (for Exchange trades) */
+    listingId?: number;
+}
+interface ZcoinCommercialTransferOutput {
+    success: true;
+    tradeId: number;
+    zcoinTxId: number;
+    ownershipEventId: number;
+    platformFee: number;
+    sellerProceeds: number;
+    primarySaleFeeApplied: boolean;
+    primarySaleFeeMarked: boolean;
+}
+interface ZcoinMintAndChargeInput {
+    /** The card to mint (probability result from Commerce) */
+    cardId: number;
+    /** The buyer's user ID (will be debited Z-coin and receive the new instance) */
+    buyerUserId: number;
+    /** Price per unit in Z-coin hundredths (e.g. 1050 = 10.50 Z-coin) */
+    priceZcoin: number;
+    /** Type of sale */
+    saleType?: "gacha" | "direct";
+    /** Idempotency key (e.g., Commerce order ID) */
+    referenceId: string;
+    /** OAuth APP client ID of the calling application */
+    appClientId: string;
+    /** Human-readable description */
+    description?: string;
+    /** Number of instances to mint (default 1, max 10 for batch gacha) */
+    quantity?: number;
+}
+interface ZcoinMintAndChargeOutput {
+    success: boolean;
+    tradeId: number;
+    zcoinTxId: number;
+    platformFee: number;
+    sellerProceeds: number;
+    authorizationId: number;
+    remainingMints: number | null;
+    instances: Array<{
+        id: number;
+        instanceCode: string;
+        shortCode: string;
+    }>;
+}
+interface ZcoinChargeUserInput {
+    /** Z-coin amount to charge (in hundredths, e.g. 1050 = 10.50 Z-coin) */
+    amount: number;
+    /** OAuth app client ID making the charge */
+    appClientId: string;
+    /** Unique order/reference ID from the APP (for idempotency) */
+    appOrderId: string;
+    /** Human-readable description of what the user is paying for */
+    description: string;
+}
+interface ZcoinChargeUserOutput {
+    success: boolean;
+    transactionId: number;
+    amountCharged: number;
+    platformFee: number;
+    developerProceeds: number;
+    balanceAfter: number;
+    referenceId: string;
+}
+interface ZcoinCreateDirectPurchaseOrderInput {
+    /** The card instance to purchase */
+    instanceId: number;
+    /** The seller's user ID */
+    sellerUserId: number;
+    /** Price in Z-coin hundredths (e.g. 5000 = 50.00 Z-coin) */
+    priceZcoin: number;
+    /** Type of sale */
+    saleType: SaleType;
+    /** OAuth APP client ID */
+    appClientId: string;
+    /** Idempotency key from the calling APP */
+    referenceId: string;
+    /** Human-readable description */
+    description?: string;
+    /** Purchase channel */
+    channel?: PurchaseChannel;
+    /** Frontend origin for redirect URLs */
+    origin: string;
+    /** Optional listing ID (for Exchange trades) */
+    listingId?: number;
+}
+interface ZcoinCreateDirectPurchaseOrderOutput {
+    sessionId: string;
+    checkoutUrl: string;
+    priceZcoin: number;
+    fiatAmountCents: number;
+    groupId: string;
+    channel: PurchaseChannel;
+    status: "pending_payment";
+}
+interface ZcoinGetDepositPackagesInput {
+    channel?: PurchaseChannel;
+}
+interface ZcoinDepositPackage {
+    id: string;
+    zcoinAmount: number;
+    zcoinHundredths: number;
+    label: string;
+    basePriceCents: number;
+    totalPriceCents: number;
+    channel: PurchaseChannel;
+    featured: boolean;
+}
+interface ZcoinCreateDepositOrderInput {
+    /** Z-coin amount to purchase (display units, e.g. 100 or 100.50) */
+    amount: number;
+    /** Purchase channel */
+    channel?: PurchaseChannel;
+    /** Frontend origin for redirect URLs */
+    origin: string;
+}
+interface ZcoinCreateDepositOrderOutput {
+    sessionId: string;
+    checkoutUrl: string;
+    zcoinAmount: number;
+    fiatAmountCents: number;
+    channel: PurchaseChannel;
+    status: "pending_payment";
+}
+interface ZcoinGetDepositStatusInput {
+    sessionId: string;
+}
+interface ZcoinGetDepositStatusOutput {
+    sessionId: string;
+    paymentStatus: string;
+    status: string;
+    zcoinAmount: number;
+    amountTotal: number | null;
+    currency: string | null;
+}
+interface InventoryGetUserInventoryInput {
+    userId?: number;
+    openId?: string;
+    seriesId?: number;
+    limit?: number;
+    offset?: number;
+}
+interface InventoryConfirmOwnershipInput {
+    userId: number;
+    cardId: number;
+}
+interface InventoryConfirmOwnershipOutput {
+    owns: boolean;
+    count: number;
+}
+interface InventoryMintInput {
+    cardId: number;
+    toUserId: number;
+    quantity?: number;
+    referenceId?: string;
+}
+interface InventoryMintOutput {
+    success: boolean;
+    cardId: number;
+    toUserId: number;
+    quantity: number;
+    instances: Array<{
+        id: number;
+        instanceCode: string;
+        shortCode: string;
+    }>;
+}
+interface InventoryTransferInput {
+    instanceId: number;
+    toUserId: number;
+    reason?: TransferReason;
+    referenceId?: string;
+    expectedVersion?: number;
+}
+interface InventoryTransferOutput {
+    success: true;
+    idempotent: boolean;
+    instanceId: number;
+    fromUserId: number | null;
+    toUserId: number;
+    reason: string;
+    eventId?: number;
+    _deprecation_warning?: string;
+}
+interface InventoryTransferByCardInput {
+    cardId: number;
+    toUserId: number;
+    quantity?: number;
+    reason?: TransferReason;
+    referenceId?: string;
+}
+interface InventoryTransferByCardOutput {
+    success: true;
+    idempotent: boolean;
+    cardId: number;
+    fromUserId: number | null;
+    toUserId: number;
+    quantity: number;
+    reason: string;
+    _deprecation_warning?: string;
+}
+interface InventoryGrantMintAuthInput {
+    cardId: number;
+    granteeUserId: number;
+    granteeAppClientId?: string;
+    maxMintCount?: number;
+    validUntilMs?: number;
+}
+interface InventoryTransferHistoryInput {
+    instanceId?: number;
+    cardId?: number;
+    userId?: number;
+    limit?: number;
+    offset?: number;
+}
+interface CollectibleGetInstanceByIdInput {
+    instanceId: number;
+    claimToken?: string;
+}
+interface CollectibleGetPublicInstanceInput {
+    instanceCode: string;
+}
+interface CollectibleGetPublicInstancesBatchInput {
+    instanceIds: number[];
+}
+interface CollectibleGetCardProfileInput {
+    cardId: number;
+}
+interface CollectibleGetShellImageUrlInput {
+    cardId: number;
+}
+interface UserGetPublicProfileInput {
+    openId: string;
+}
+interface UserPublicProfile {
+    openId: string;
+    name: string;
+    avatarUrl: string | null;
+    joinedAt: Date;
+    stats: {
+        totalOwned: number;
+    };
+}
+interface UserGetPublicProfileByIdInput {
+    userId: number;
+}
+interface AuthGetOAuthAppInfoInput {
+    clientId: string;
+}
+interface AuthOAuthAppInfo {
+    appName: string;
+    iconUrl: string | null;
+    websiteUrl: string | null;
+}
+interface AuthUser {
+    id: number;
+    openId: string;
+    name: string;
+    email: string | null;
+    avatarUrl: string | null;
+    role: "admin" | "user";
+}
+interface FranchiseGetInput {
+    id?: number;
+    slug?: string;
+}
+interface SeriesGetInput {
+    id?: number;
+    slug?: string;
+}
+interface SeriesListByFranchiseInput {
+    franchiseId: number;
+}
+interface CardGetInput {
+    id: number;
+}
+interface CardListBySeriesInput {
+    seriesId: number;
+}
+interface GoodZApiFieldError {
+    path: (string | number)[];
+    message: string;
+    code: string;
+}
+/**
+ * Structured error from GoodZ.Core API.
+ * Includes tRPC error code, HTTP status, and optional Zod validation details.
+ */
+interface GoodZErrorV2 {
+    type: string;
+    code: string;
+    message: string;
+    httpStatus: number;
+}
+
+/**
+ * @goodz-core/sdk — HTTP Transport Layer
+ *
+ * Speaks the tRPC v11 HTTP wire protocol directly using fetch.
+ * Handles superjson serialization, batching, and error parsing.
+ *
+ * Wire format reference:
+ * - Queries:   GET  /api/trpc/{procedure}?input={superjson-encoded}
+ * - Mutations: POST /api/trpc/{procedure}  body: {superjson-encoded}
+ * - Batch:     GET  /api/trpc/{p1},{p2}?input={0: ..., 1: ...}
+ *
+ * @internal
+ */
+
+declare class GoodZApiError extends Error {
+    readonly code: string;
+    readonly httpStatus: number;
+    readonly path: string;
+    readonly zodErrors?: GoodZApiFieldError[];
+    readonly data?: unknown;
+    constructor(opts: {
+        message: string;
+        code: string;
+        httpStatus: number;
+        path: string;
+        zodErrors?: GoodZApiFieldError[];
+        data?: unknown;
+    });
+    /** Human-readable summary including field errors if present. */
+    toDetailedString(): string;
+}
+
+/**
+ * @goodz-core/sdk/core — Type-safe API client for GoodZ.Core
+ *
+ * Zero tRPC dependency — speaks the tRPC HTTP wire protocol directly
+ * using fetch + superjson. All types are hand-crafted and self-contained.
+ *
+ * @example
+ * ```ts
+ * import { createGoodZClient } from "@goodz-core/sdk/core";
+ *
+ * const goodz = createGoodZClient({
+ *   coreUrl: "https://goodzcore.manus.space",
+ *   accessToken: "your-jwt-token",
+ * });
+ *
+ * // Fully typed — IDE autocomplete for all inputs and outputs
+ * const balance = await goodz.zcoin.getMyBalance();
+ * const result = await goodz.zcoin.commercialTransfer({ ... });
+ * const instance = await goodz.collectible.getInstanceById({ instanceId: 90447 });
+ * ```
+ *
+ * @module
+ */
+
+interface GoodZClientConfig {
+    /**
+     * GoodZ.Core base URL.
+     * @default "https://goodzcore.manus.space"
+     */
+    coreUrl?: string;
+    /**
+     * Static access token (JWT) for authentication.
+     * For server-to-server calls, obtain this via OAuth client_credentials flow.
+     * For user-context calls, pass the user's access token.
+     */
+    accessToken?: string;
+    /**
+     * Dynamic token provider — called before every request.
+     * Use this when tokens may rotate (e.g., auto-refresh).
+     * Takes precedence over `accessToken` if both are set.
+     */
+    getAccessToken?: () => string | Promise<string>;
+    /**
+     * Custom headers to include in every request.
+     * Useful for passing app identifiers or tracing headers.
+     */
+    headers?: Record<string, string>;
+}
+interface ZcoinNamespace {
+    /** Get the authenticated user's Z-coin balance. */
+    getMyBalance(): Promise<ZcoinGetMyBalanceOutput>;
+    /** Get the authenticated user's Z-coin transaction history. */
+    getMyHistory(input?: ZcoinGetMyHistoryInput): Promise<any[]>;
+    /** Get available Z-coin deposit packages with pricing. */
+    getDepositPackages(input?: ZcoinGetDepositPackagesInput): Promise<ZcoinDepositPackage[]>;
+    /** Create a Stripe checkout session for Z-coin deposit. */
+    createDepositOrder(input: ZcoinCreateDepositOrderInput): Promise<ZcoinCreateDepositOrderOutput>;
+    /** Check the status of a deposit checkout session. */
+    getDepositStatus(input: ZcoinGetDepositStatusInput): Promise<ZcoinGetDepositStatusOutput>;
+    /**
+     * Atomic commercial transfer: Z-coin payment + ownership transfer in one transaction.
+     * This is the primary API for Commerce and Exchange purchase flows.
+     *
+     * Idempotent via referenceId — duplicate calls return the same result.
+     *
+     * @throws {GoodZApiError} BAD_REQUEST — insufficient balance
+     * @throws {GoodZApiError} CONFLICT — version conflict (retry)
+     * @throws {GoodZApiError} FORBIDDEN — seller doesn't own instance
+     */
+    commercialTransfer(input: ZcoinCommercialTransferInput): Promise<ZcoinCommercialTransferOutput>;
+    /**
+     * Mint a new card instance and charge the buyer in one atomic transaction.
+     * Used by Commerce for gacha and direct-from-creator purchases.
+     *
+     * Requires mint authorization (granted via inventory.grantMintAuth).
+     * Idempotent via referenceId.
+     *
+     * @throws {GoodZApiError} FORBIDDEN — no mint authorization
+     * @throws {GoodZApiError} BAD_REQUEST — insufficient balance
+     */
+    mintAndCharge(input: ZcoinMintAndChargeInput): Promise<ZcoinMintAndChargeOutput>;
+    /**
+     * Charge a user's Z-coin balance for an in-app purchase.
+     * Used by apps that sell non-GoodZ digital goods/services.
+     *
+     * Idempotent via appOrderId.
+     *
+     * @throws {GoodZApiError} BAD_REQUEST — insufficient balance
+     * @throws {GoodZApiError} CONFLICT — version conflict
+     */
+    chargeUser(input: ZcoinChargeUserInput): Promise<ZcoinChargeUserOutput>;
+    /**
+     * Create a direct purchase checkout session (fiat → Z-coin → transfer).
+     * Transparent intermediation: user sees fiat price, Core handles conversion.
+     */
+    createDirectPurchaseOrder(input: ZcoinCreateDirectPurchaseOrderInput): Promise<ZcoinCreateDirectPurchaseOrderOutput>;
+}
+interface InventoryNamespace {
+    /** Get a user's inventory (owned card instances). */
+    getUserInventory(input: InventoryGetUserInventoryInput): Promise<any[]>;
+    /** Check if a user owns at least one instance of a specific card. */
+    confirmOwnership(input: InventoryConfirmOwnershipInput): Promise<InventoryConfirmOwnershipOutput>;
+    /**
+     * Mint new card instances. Requires franchise ownership or admin role.
+     * For Commerce/Exchange, use zcoin.mintAndCharge instead (includes payment).
+     */
+    mint(input: InventoryMintInput): Promise<InventoryMintOutput>;
+    /**
+     * Transfer a specific card instance to another user.
+     * For commercial transfers, use zcoin.commercialTransfer instead.
+     *
+     * @deprecated for reason="purchase"|"trade" — use commercialTransfer
+     */
+    transfer(input: InventoryTransferInput): Promise<InventoryTransferOutput>;
+    /**
+     * Transfer card instances by cardId (transfers oldest instances).
+     * For commercial transfers, use zcoin.commercialTransfer instead.
+     *
+     * @deprecated for reason="purchase"|"trade" — use commercialTransfer
+     */
+    transferByCard(input: InventoryTransferByCardInput): Promise<InventoryTransferByCardOutput>;
+    /**
+     * Grant mint authorization to another user/app for a specific card.
+     * Required before Commerce can call zcoin.mintAndCharge for that card.
+     */
+    grantMintAuth(input: InventoryGrantMintAuthInput): Promise<any>;
+    /** Get transfer/ownership history for an instance, card, or user. */
+    transferHistory(input: InventoryTransferHistoryInput): Promise<any[]>;
+}
+interface CollectibleNamespace {
+    /** Get a card instance by its numeric ID. Returns full instance data with card chain. */
+    getInstanceById(input: CollectibleGetInstanceByIdInput): Promise<any>;
+    /** Get a card instance by its instance code (public-facing identifier). */
+    getPublicInstance(input: CollectibleGetPublicInstanceInput): Promise<any>;
+    /** Batch-fetch multiple card instances by their IDs (max 100). */
+    getPublicInstancesBatch(input: CollectibleGetPublicInstancesBatchInput): Promise<any[]>;
+    /** Get the card profile (metadata, rarity, series info). */
+    getCardProfile(input: CollectibleGetCardProfileInput): Promise<any>;
+    /** Get the shell (packaging) image URL for a card. */
+    getShellImageUrl(input: CollectibleGetShellImageUrlInput): Promise<any>;
+}
+interface UserNamespace {
+    /** Get a user's public profile by openId. */
+    getPublicProfile(input: UserGetPublicProfileInput): Promise<UserPublicProfile>;
+    /** Get a user's public profile by internal userId. */
+    getPublicProfileById(input: UserGetPublicProfileByIdInput): Promise<UserPublicProfile>;
+}
+interface AuthNamespace {
+    /** Get the authenticated user's profile. Returns null if not authenticated. */
+    me(): Promise<AuthUser | null>;
+    /** Get public info about an OAuth app by its client ID. */
+    getOAuthAppInfo(input: AuthGetOAuthAppInfoInput): Promise<AuthOAuthAppInfo | null>;
+}
+interface IpNamespace {
+    /** Get a franchise by ID or slug. */
+    getFranchise(input: FranchiseGetInput): Promise<any>;
+    /** Get a series by ID or slug. */
+    getSeries(input: SeriesGetInput): Promise<any>;
+    /** List all series in a franchise. */
+    listSeriesByFranchise(input: SeriesListByFranchiseInput): Promise<any[]>;
+    /** Get a card by ID. */
+    getCard(input: CardGetInput): Promise<any>;
+    /** List all cards in a series. */
+    listCardsBySeries(input: CardListBySeriesInput): Promise<any[]>;
+}
+interface GoodZClient {
+    readonly zcoin: ZcoinNamespace;
+    readonly inventory: InventoryNamespace;
+    readonly collectible: CollectibleNamespace;
+    readonly user: UserNamespace;
+    readonly auth: AuthNamespace;
+    readonly ip: IpNamespace;
+    /**
+     * Make a raw tRPC query call. Use this for routes not yet covered
+     * by the typed namespaces.
+     */
+    rawQuery<T = any>(path: string, input?: any): Promise<T>;
+    /**
+     * Make a raw tRPC mutation call. Use this for routes not yet covered
+     * by the typed namespaces.
+     */
+    rawMutation<T = any>(path: string, input?: any): Promise<T>;
+}
+/**
+ * Create a type-safe GoodZ.Core API client.
+ *
+ * @example Server-to-server with static token
+ * ```ts
+ * const goodz = createGoodZClient({
+ *   accessToken: process.env.CORE_ACCESS_TOKEN,
+ * });
+ * ```
+ *
+ * @example With dynamic token provider (auto-refresh)
+ * ```ts
+ * const goodz = createGoodZClient({
+ *   getAccessToken: async () => {
+ *     const token = await refreshTokenIfNeeded();
+ *     return token;
+ *   },
+ * });
+ * ```
+ *
+ * @example Acting on behalf of a user
+ * ```ts
+ * const userGoodz = createGoodZClient({
+ *   accessToken: userAccessToken,
+ * });
+ * const balance = await userGoodz.zcoin.getMyBalance();
+ * ```
+ */
+declare function createGoodZClient(config?: GoodZClientConfig): GoodZClient;
+/**
+ * Alias for createGoodZClient — creates a client acting on behalf of a user.
+ * Semantically identical, but makes the intent clearer in server-to-server code.
+ */
+declare const createUserClient: typeof createGoodZClient;
+
+export { type AuthGetOAuthAppInfoInput, type AuthNamespace, type AuthOAuthAppInfo, type AuthUser, type CardGetInput, type CardListBySeriesInput, type CollectibleGetCardProfileInput, type CollectibleGetInstanceByIdInput, type CollectibleGetPublicInstanceInput, type CollectibleGetPublicInstancesBatchInput, type CollectibleGetShellImageUrlInput, type CollectibleNamespace, type FranchiseGetInput, GoodZApiError, type GoodZApiFieldError, type GoodZClient, type GoodZClientConfig, type GoodZErrorV2, type InventoryConfirmOwnershipInput, type InventoryConfirmOwnershipOutput, type InventoryGetUserInventoryInput, type InventoryGrantMintAuthInput, type InventoryMintInput, type InventoryMintOutput, type InventoryNamespace, type InventoryTransferByCardInput, type InventoryTransferByCardOutput, type InventoryTransferHistoryInput, type InventoryTransferInput, type InventoryTransferOutput, type IpNamespace, type PurchaseChannel, type SaleType, type SeriesGetInput, type SeriesListByFranchiseInput, type TransferReason, type UserGetPublicProfileByIdInput, type UserGetPublicProfileInput, type UserNamespace, type UserPublicProfile, type ZcoinChargeUserInput, type ZcoinChargeUserOutput, type ZcoinCommercialTransferInput, type ZcoinCommercialTransferOutput, type ZcoinCreateDepositOrderInput, type ZcoinCreateDepositOrderOutput, type ZcoinCreateDirectPurchaseOrderInput, type ZcoinCreateDirectPurchaseOrderOutput, type ZcoinDepositPackage, type ZcoinGetDepositPackagesInput, type ZcoinGetDepositStatusInput, type ZcoinGetDepositStatusOutput, type ZcoinGetMyBalanceOutput, type ZcoinGetMyHistoryInput, type ZcoinMintAndChargeInput, type ZcoinMintAndChargeOutput, type ZcoinNamespace, type ZcoinTxType, createGoodZClient, createUserClient };

package/dist/core/index.js

@@ -0,0 +1,3 @@
+export { GoodZApiError, createGoodZClient, createUserClient } from '../chunk-G7NKU6PT.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export { AuthGetOAuthAppInfoInput, AuthNamespace, AuthOAuthAppInfo, AuthUser, CardGetInput, CardListBySeriesInput, CollectibleGetCardProfileInput, CollectibleGetInstanceByIdInput, CollectibleGetPublicInstanceInput, CollectibleGetPublicInstancesBatchInput, CollectibleGetShellImageUrlInput, CollectibleNamespace, FranchiseGetInput, GoodZApiError, GoodZApiFieldError, GoodZClient, GoodZClientConfig, GoodZErrorV2, InventoryConfirmOwnershipInput, InventoryConfirmOwnershipOutput, InventoryGetUserInventoryInput, InventoryGrantMintAuthInput, InventoryMintInput, InventoryMintOutput, InventoryNamespace, InventoryTransferByCardInput, InventoryTransferByCardOutput, InventoryTransferHistoryInput, InventoryTransferInput, InventoryTransferOutput, IpNamespace, PurchaseChannel, SaleType, SeriesGetInput, SeriesListByFranchiseInput, TransferReason, UserGetPublicProfileByIdInput, UserGetPublicProfileInput, UserNamespace, UserPublicProfile, ZcoinChargeUserInput, ZcoinChargeUserOutput, ZcoinCommercialTransferInput, ZcoinCommercialTransferOutput, ZcoinCreateDepositOrderInput, ZcoinCreateDepositOrderOutput, ZcoinCreateDirectPurchaseOrderInput, ZcoinCreateDirectPurchaseOrderOutput, ZcoinDepositPackage, ZcoinGetDepositPackagesInput, ZcoinGetDepositStatusInput, ZcoinGetDepositStatusOutput, ZcoinGetMyBalanceOutput, ZcoinGetMyHistoryInput, ZcoinMintAndChargeInput, ZcoinMintAndChargeOutput, ZcoinNamespace, ZcoinTxType, createGoodZClient, createUserClient } from './core/index.js';
+export { OAuthUrlConfig, TokenManager, TokenManagerConfig, TokenPair, buildAuthorizationUrl, exchangeCode } from './auth/index.js';
+export { ZCOIN_PRECISION, formatZcoin, formatZcoinWithSymbol, toDisplay, toHundredths } from './zcoin-utils.js';
+
+/**
+ * @goodz-core/sdk — Official SDK for GoodZ.Core
+ *
+ * This is the main entry point that re-exports all submodules.
+ * For tree-shaking, prefer importing from specific subpaths:
+ *
+ * ```ts
+ * import { createGoodZClient } from "@goodz-core/sdk/core";
+ * import { TokenManager } from "@goodz-core/sdk/auth";
+ * ```
+ *
+ * @module
+ */
+
+declare const SDK_VERSION = "0.1.0";
+
+export { SDK_VERSION };

package/dist/index.js

@@ -0,0 +1,10 @@
+export { GoodZApiError, createGoodZClient, createUserClient } from './chunk-G7NKU6PT.js';
+export { TokenManager, buildAuthorizationUrl, exchangeCode } from './chunk-EUKUN4JF.js';
+export { ZCOIN_PRECISION, formatZcoin, formatZcoinWithSymbol, toDisplay, toHundredths } from './chunk-2ZETOE2X.js';
+
+// src/index.ts
+var SDK_VERSION = "0.1.0";
+
+export { SDK_VERSION };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;AAoDO,IAAM,WAAA,GAAc","file":"index.js","sourcesContent":["/**\n * @goodz-core/sdk — Official SDK for GoodZ.Core\n *\n * This is the main entry point that re-exports all submodules.\n * For tree-shaking, prefer importing from specific subpaths:\n *\n * ```ts\n * import { createGoodZClient } from \"@goodz-core/sdk/core\";\n * import { TokenManager } from \"@goodz-core/sdk/auth\";\n * ```\n *\n * @module\n */\n\n// Core client\nexport {\n  createGoodZClient,\n  createUserClient,\n  GoodZApiError,\n  type GoodZClient,\n  type GoodZClientConfig,\n  type ZcoinNamespace,\n  type InventoryNamespace,\n  type CollectibleNamespace,\n  type UserNamespace,\n  type AuthNamespace,\n  type IpNamespace,\n} from \"./core/index\";\n\n// All API types\nexport type * from \"./types\";\n\n// Auth helpers\nexport {\n  TokenManager,\n  buildAuthorizationUrl,\n  exchangeCode,\n  type TokenManagerConfig,\n  type TokenPair,\n  type OAuthUrlConfig,\n} from \"./auth/index\";\n\n// Z-coin utilities\nexport {\n  ZCOIN_PRECISION,\n  toHundredths,\n  toDisplay,\n  formatZcoin,\n  formatZcoinWithSymbol,\n} from \"./zcoin-utils\";\n\n// SDK version\nexport const SDK_VERSION = \"0.1.0\";\n"]}

package/dist/zcoin-utils.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @goodz-core/sdk — Z-coin Precision Utilities
+ *
+ * GoodZ.Core stores Z-coin amounts in "hundredths" (1/100th of a Z-coin).
+ * For example, 10.50 Z-coin is stored as 1050 hundredths.
+ *
+ * These helpers convert between display values and hundredths to prevent
+ * the off-by-100x errors that plagued early Commerce integration.
+ *
+ * @module
+ */
+/** Precision multiplier: 1 Z-coin = 100 hundredths */
+declare const ZCOIN_PRECISION = 100;
+/**
+ * Convert a display Z-coin amount to hundredths for API calls.
+ *
+ * @example
+ * ```ts
+ * toHundredths(10.50)  // → 1050
+ * toHundredths(100)    // → 10000
+ * toHundredths(0.01)   // → 1
+ * ```
+ */
+declare function toHundredths(displayAmount: number): number;
+/**
+ * Convert hundredths to a display Z-coin amount.
+ *
+ * @example
+ * ```ts
+ * toDisplay(1050)   // → 10.5
+ * toDisplay(10000)  // → 100
+ * toDisplay(1)      // → 0.01
+ * ```
+ */
+declare function toDisplay(hundredths: number): number;
+/**
+ * Format a hundredths value as a display string with 2 decimal places.
+ *
+ * @example
+ * ```ts
+ * formatZcoin(1050)   // → "10.50"
+ * formatZcoin(10000)  // → "100.00"
+ * formatZcoin(1)      // → "0.01"
+ * ```
+ */
+declare function formatZcoin(hundredths: number): string;
+/**
+ * Format a hundredths value as a display string with the Z-coin symbol.
+ *
+ * @example
+ * ```ts
+ * formatZcoinWithSymbol(1050)   // → "Z 10.50"
+ * formatZcoinWithSymbol(10000)  // → "Z 100.00"
+ * ```
+ */
+declare function formatZcoinWithSymbol(hundredths: number): string;
+
+export { ZCOIN_PRECISION, formatZcoin, formatZcoinWithSymbol, toDisplay, toHundredths };