@sly-rentals/core 0.1.0

package/dist/esm/utils/rpc.js

@@ -0,0 +1,52 @@
+/**
+ * @purpose Centralized RPC client creation for SRSLY SDK
+ *
+ * Provides a single point for creating Solana RPC clients, making it easier
+ * to add environment-specific configurations or debugging in the future.
+ */
+import { createSolanaRpc } from '@solana/kit';
+// Debug flag - can be set via setSdkConfig or environment
+let debugMode = false;
+/**
+ * Enable or disable RPC debug mode
+ * When enabled, logs RPC requests to console
+ */
+export function setRpcDebug(enabled) {
+    debugMode = enabled;
+}
+/**
+ * Check if RPC debug mode is enabled
+ */
+export function isRpcDebugEnabled() {
+    return debugMode;
+}
+/**
+ * Create a Solana RPC client
+ *
+ * This utility centralizes RPC client creation for the SDK. While it currently
+ * uses the standard createSolanaRpc approach, having a single point of creation
+ * makes it easier to:
+ * - Add debugging/logging
+ * - Handle environment-specific configurations
+ * - Implement retry logic or custom transports
+ *
+ * @param rpcUrl - The RPC endpoint URL
+ * @returns A configured Solana RPC client
+ *
+ * @example
+ * ```typescript
+ * const rpc = createRpc('https://api.devnet.solana.com');
+ * const account = await rpc.getAccountInfo(address).send();
+ * ```
+ */
+export function createRpc(rpcUrl) {
+    if (debugMode) {
+        console.log('[SRSLY RPC Debug] Creating RPC client:', {
+            url: rpcUrl,
+            environment: typeof window !== 'undefined' ? 'browser' : 'node',
+            userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : 'N/A',
+        });
+    }
+    return createSolanaRpc(rpcUrl);
+}
+//# sourceMappingURL=rpc.js.map

package/dist/esm/utils/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../../src/utils/rpc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAA+B,MAAM,aAAa,CAAC;AAE3E,0DAA0D;AAC1D,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,SAAS,GAAG,OAAO,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,wCAAwC,EAAE;YACpD,GAAG,EAAE,MAAM;YACX,WAAW,EAAE,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;YAC/D,SAAS,EAAE,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK;SAC1E,CAAC,CAAC;IACL,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AACjC,CAAC"}

package/dist/esm/utils/signer.js

@@ -0,0 +1,147 @@
+/**
+ * @purpose Universal signer handling for @solana/kit and @solana/web3.js compatibility
+ *
+ * Accepts signers from both libraries and extracts address strings for use with Codama.
+ */
+import { createNoopSigner, address } from '@solana/kit';
+/**
+ * Extract address string from any supported signer format
+ *
+ * @param signer - Signer in any supported format
+ * @returns Base58-encoded address string
+ * @throws Error if signer format is invalid
+ *
+ * @example
+ * ```typescript
+ * // String address
+ * const addr1 = getSignerAddress("9WzDXw...");
+ *
+ * // web3.js Keypair
+ * import { Keypair } from '@solana/web3.js';
+ * const keypair = Keypair.generate();
+ * const addr2 = getSignerAddress(keypair);
+ *
+ * // @solana/kit signer
+ * import { createNoopSigner, address } from '@solana/kit';
+ * const kitSigner = createNoopSigner(address("9WzDXw..."));
+ * const addr3 = getSignerAddress(kitSigner);
+ * ```
+ */
+export function getSignerAddress(signer) {
+    // Handle string address
+    if (typeof signer === 'string') {
+        validateAddress(signer);
+        return address(signer);
+    }
+    // Handle object signers
+    if (signer && typeof signer === 'object') {
+        // web3.js Keypair/Wallet format (has publicKey.toBase58())
+        if ('publicKey' in signer &&
+            signer.publicKey &&
+            typeof signer.publicKey.toBase58 === 'function') {
+            const addr = signer.publicKey.toBase58();
+            validateAddress(addr);
+            return address(addr);
+        }
+        // web3.js PublicKey format (has direct toBase58())
+        if ('toBase58' in signer && typeof signer.toBase58 === 'function') {
+            const addr = signer.toBase58();
+            validateAddress(addr);
+            return address(addr);
+        }
+        // @solana/kit signer format
+        if ('address' in signer) {
+            const addr = String(signer.address);
+            validateAddress(addr);
+            return address(addr);
+        }
+    }
+    throw new Error('Invalid signer format. Expected:\n' +
+        '  - string address\n' +
+        '  - web3.js Keypair (with publicKey.toBase58())\n' +
+        '  - web3.js PublicKey (with toBase58())\n' +
+        '  - @solana/kit TransactionSigner (with address property)');
+}
+/**
+ * Validate that a string is a valid Solana address
+ *
+ * Basic validation - checks length only. For full validation,
+ * use @solana/kit's address() function or web3.js PublicKey constructor.
+ *
+ * @param address - Address string to validate
+ * @throws Error if address format is invalid
+ */
+export function validateAddress(address) {
+    if (typeof address !== 'string') {
+        throw new Error(`Address must be a string, got ${typeof address}`);
+    }
+    // Solana addresses are base58-encoded 32-byte values
+    // Base58 encoding of 32 bytes = 32-44 characters (typically 43-44)
+    if (address.length < 32 || address.length > 44) {
+        throw new Error(`Invalid Solana address length: ${address.length}. ` +
+            `Expected 32-44 characters (base58-encoded 32 bytes). ` +
+            `Got: "${address}"`);
+    }
+    // Check for invalid base58 characters
+    const base58Regex = /^[1-9A-HJ-NP-Za-km-z]+$/;
+    if (!base58Regex.test(address)) {
+        throw new Error(`Invalid Solana address characters. ` +
+            `Address must be base58-encoded (no 0, O, I, or l characters). ` +
+            `Got: "${address}"`);
+    }
+}
+/**
+ * Type guard to check if a value is a web3.js signer
+ */
+export function isWeb3jsSigner(signer) {
+    return (typeof signer === 'object' &&
+        signer !== null &&
+        'publicKey' in signer &&
+        typeof signer.publicKey?.toBase58 === 'function');
+}
+/**
+ * Type guard to check if a value is a @solana/kit signer
+ */
+export function isKitSigner(signer) {
+    return typeof signer === 'object' && signer !== null && 'address' in signer;
+}
+/**
+ * Type guard to check if a value is a string address
+ */
+export function isAddressString(signer) {
+    return typeof signer === 'string';
+}
+/**
+ * Convert UniversalSigner to TransactionSigner
+ *
+ * Intelligently handles different signer types:
+ * - If already a TransactionSigner with signing capability → return as-is
+ * - Otherwise → create noop signer from address (for browser/wallet cases)
+ *
+ * This enables the SDK to work in both:
+ * - Browser/wallet contexts (where you only have addresses, not private keys)
+ * - CLI/backend contexts (where you have full keypair signers)
+ *
+ * @param signer - Signer in any supported format
+ * @returns TransactionSigner (either real or noop)
+ *
+ * @example
+ * ```typescript
+ * // CLI/backend - has private key
+ * const wallet = await createKeyPairSignerFromBytes(secretKey);
+ * const txSigner = toTransactionSigner(wallet); // Returns wallet as-is
+ *
+ * // Browser - only has address
+ * const walletAddress = "9WzDXw...";
+ * const txSigner = toTransactionSigner(walletAddress); // Creates noop signer
+ * ```
+ */
+export function toTransactionSigner(signer) {
+    // If already a TransactionSigner with signing capability, use it directly
+    if (typeof signer === 'object' && signer !== null && 'signMessages' in signer) {
+        return signer;
+    }
+    // Otherwise, extract address and create noop signer (for browser/wallet cases)
+    return createNoopSigner(getSignerAddress(signer));
+}
+//# sourceMappingURL=signer.js.map

package/dist/esm/utils/signer.js.map

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

package/dist/esm/utils/web3js.js

@@ -0,0 +1,72 @@
+/**
+ * @purpose Conversion helpers for @solana/web3.js compatibility
+ *
+ * Converts between @solana/kit and @solana/web3.js instruction formats.
+ */
+/**
+ * Convert @solana/kit instruction to @solana/web3.js format
+ *
+ * @param kitInstruction - Instruction in @solana/kit format (from Codama)
+ * @param PublicKey - Optional PublicKey constructor for web3.js compatibility
+ * @returns Instruction in @solana/web3.js format
+ *
+ * @example
+ * ```typescript
+ * // Without PublicKey - returns string addresses
+ * const web3Ix = toWeb3Instruction(kitIx);
+ * // web3Ix.keys[0].pubkey is a string
+ *
+ * // With PublicKey - returns PublicKey instances
+ * import { PublicKey } from '@solana/web3.js';
+ * const web3Ix = toWeb3Instruction(kitIx, PublicKey);
+ * // web3Ix.keys[0].pubkey is a PublicKey instance
+ * ```
+ */
+export function toWeb3Instruction(kitInstruction, PublicKey) {
+    const { accounts = [], programAddress, data } = kitInstruction;
+    if (PublicKey) {
+        // Return instruction with PublicKey instances
+        return {
+            keys: accounts.map(account => ({
+                pubkey: new PublicKey(account.address),
+                isWritable: (account.role & 1) === 1, // Check writable bit
+                isSigner: (account.role & 2) === 2, // Check signer bit
+            })),
+            programId: new PublicKey(programAddress),
+            data: data || new Uint8Array(),
+        };
+    }
+    // Return instruction with string addresses
+    return {
+        keys: accounts.map(account => ({
+            pubkey: account.address,
+            isWritable: (account.role & 1) === 1,
+            isSigner: (account.role & 2) === 2,
+        })),
+        programId: programAddress,
+        data: data || new Uint8Array(),
+    };
+}
+/**
+ * Convert PublicKey or Address to string
+ *
+ * Helper function for normalizing addresses from different libraries.
+ *
+ * @param value - Address as string or PublicKey instance
+ * @returns Base58-encoded address string
+ *
+ * @example
+ * ```typescript
+ * // String address (passthrough)
+ * const addr1 = toAddress("9WzDXw...");
+ *
+ * // web3.js PublicKey
+ * import { PublicKey } from '@solana/web3.js';
+ * const pubkey = new PublicKey("9WzDXw...");
+ * const addr2 = toAddress(pubkey);
+ * ```
+ */
+export function toAddress(value) {
+    return typeof value === 'string' ? value : value.toBase58();
+}
+//# sourceMappingURL=web3js.js.map

package/dist/esm/utils/web3js.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web3js.js","sourceRoot":"","sources":["../../../src/utils/web3js.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4CH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,cAA8B,EAC9B,SAA4C;IAE5C,MAAM,EAAE,QAAQ,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,cAAc,CAAC;IAE/D,IAAI,SAAS,EAAE,CAAC;QACd,8CAA8C;QAC9C,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC7B,MAAM,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;gBACtC,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,qBAAqB;gBAC3D,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,mBAAmB;aACxD,CAAC,CAAC;YACH,SAAS,EAAE,IAAI,SAAS,CAAC,cAAc,CAAC;YACxC,IAAI,EAAE,IAAI,IAAI,IAAI,UAAU,EAAE;SAC/B,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC7B,MAAM,EAAE,OAAO,CAAC,OAAO;YACvB,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC;YACpC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC;SACnC,CAAC,CAAC;QACH,SAAS,EAAE,cAAc;QACzB,IAAI,EAAE,IAAI,IAAI,IAAI,UAAU,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,SAAS,CAAC,KAAsC;IAC9D,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC9D,CAAC"}

package/dist/esm/version.js

@@ -0,0 +1,4 @@
+// Auto-generated from package.json - DO NOT EDIT
+// Run "pnpm run generate:version" to update
+export const VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}