@oobe-protocol-labs/synapse-client-sdk 1.0.0-beta → 1.0.2

package/dist/cjs/grpc/transport.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @module grpc/transport
+ * @description GrpcTransport — thin adapter over `@grpc/grpc-js`.
+ * Uses dynamic `require` so the module stays optional. Provides proto
+ * loading, service stub creation, and promise-based unary calls.
+ *
+ * **Node.js only** — gRPC relies on native C++ bindings and HTTP/2 framing
+ * that are not available in browser environments. Instantiating this class
+ * in a browser will throw a descriptive error.
+ *
+ * @since 1.0.0
+ */
+import type { GrpcTransportConfig, GrpcCallOptions } from './types';
+/**
+ * Thin adapter over `@grpc/grpc-js` for performing gRPC calls.
+ *
+ * Dependencies (`@grpc/grpc-js`, `@grpc/proto-loader`) are loaded lazily
+ * at runtime so they remain optional peer dependencies.
+ *
+ * @example
+ * ```ts
+ * const transport = new GrpcTransport({
+ *   endpoint: 'localhost:50051',
+ *   protoPath: './geyser.proto',
+ *   packageName: 'geyser',
+ * });
+ * transport.loadProto();
+ * const svc = transport.getService<GeyserService>('Geyser');
+ * const result = await transport.unary(svc, 'GetSlot', {});
+ * ```
+ * @since 1.0.0
+ */
+export declare class GrpcTransport {
+    private readonly cfg;
+    private grpc;
+    private protoLoader;
+    private services;
+    private loaded;
+    /**
+     * Create a new gRPC transport instance.
+     *
+     * @param cfg - Transport configuration options.
+     * @throws {Error} If instantiated in a browser environment.
+     * @since 1.0.0
+     */
+    constructor(cfg: GrpcTransportConfig);
+    /**
+     * Lazy-load gRPC dependencies (`@grpc/grpc-js` and `@grpc/proto-loader`).
+     *
+     * @throws {Error} If the peer dependencies are not installed.
+     * @since 1.0.0
+     */
+    private ensureLoaded;
+    /**
+     * Load a `.proto` file and register all discovered service constructors.
+     *
+     * @param protoPath - Path to the `.proto` file. Falls back to {@link GrpcTransportConfig.protoPath}.
+     * @param packageName - Dot-separated package name. Falls back to {@link GrpcTransportConfig.packageName}.
+     * @throws {Error} If no proto path is provided or a package segment is missing.
+     * @since 1.0.0
+     */
+    loadProto(protoPath?: string, packageName?: string): void;
+    /**
+     * Get or create a gRPC service stub connected to the configured endpoint.
+     *
+     * @typeParam T - The expected service stub type.
+     * @param serviceName - Name of the service as defined in the `.proto` file.
+     * @returns A connected service stub instance.
+     * @throws {Error} If the service has not been loaded via {@link loadProto}.
+     * @since 1.0.0
+     */
+    getService<T = any>(serviceName: string): T;
+    /**
+     * Execute a unary gRPC call wrapped in a promise.
+     *
+     * Automatically applies metadata and deadline from both the transport
+     * configuration and per-call options.
+     *
+     * @typeParam TReq - Request message type.
+     * @typeParam TRes - Response message type.
+     * @param service - The service stub obtained from {@link getService}.
+     * @param method - The RPC method name on the service.
+     * @param request - The request payload.
+     * @param opts - Optional per-call overrides for deadline and metadata.
+     * @returns A promise that resolves with the response message.
+     * @since 1.0.0
+     */
+    unary<TReq, TRes>(service: any, method: string, request: TReq, opts?: GrpcCallOptions): Promise<TRes>;
+    /**
+     * Clear all cached service stubs.
+     *
+     * @since 1.0.0
+     */
+    close(): void;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/cjs/grpc/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/grpc/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAOpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IAaZ,OAAO,CAAC,QAAQ,CAAC,GAAG;IAZhC,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;;;OAMG;gBAC0B,GAAG,EAAE,mBAAmB;IAUrD;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAcpB;;;;;;;OAOG;IACH,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IA8BzD;;;;;;;;OAQG;IACH,UAAU,CAAC,CAAC,GAAG,GAAG,EAAE,WAAW,EAAE,MAAM,GAAG,CAAC;IAY3C;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,EACd,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,IAAI,EACb,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/cjs/grpc/transport.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrpcTransport = void 0;
+const env_1 = require("../utils/env");
+/**
+ * Thin adapter over `@grpc/grpc-js` for performing gRPC calls.
+ *
+ * Dependencies (`@grpc/grpc-js`, `@grpc/proto-loader`) are loaded lazily
+ * at runtime so they remain optional peer dependencies.
+ *
+ * @example
+ * ```ts
+ * const transport = new GrpcTransport({
+ *   endpoint: 'localhost:50051',
+ *   protoPath: './geyser.proto',
+ *   packageName: 'geyser',
+ * });
+ * transport.loadProto();
+ * const svc = transport.getService<GeyserService>('Geyser');
+ * const result = await transport.unary(svc, 'GetSlot', {});
+ * ```
+ * @since 1.0.0
+ */
+class GrpcTransport {
+    cfg;
+    grpc;
+    protoLoader;
+    services = new Map();
+    loaded = false;
+    /**
+     * Create a new gRPC transport instance.
+     *
+     * @param cfg - Transport configuration options.
+     * @throws {Error} If instantiated in a browser environment.
+     * @since 1.0.0
+     */
+    constructor(cfg) {
+        this.cfg = cfg;
+        if ((0, env_1.isBrowser)()) {
+            throw new Error('GrpcTransport is not available in browser environments. ' +
+                'gRPC requires native Node.js bindings (@grpc/grpc-js). ' +
+                'Use the HTTP RPC or WebSocket client for browser/Next.js client components.');
+        }
+    }
+    /**
+     * Lazy-load gRPC dependencies (`@grpc/grpc-js` and `@grpc/proto-loader`).
+     *
+     * @throws {Error} If the peer dependencies are not installed.
+     * @since 1.0.0
+     */
+    ensureLoaded() {
+        if (this.loaded)
+            return;
+        try {
+            this.grpc = require('@grpc/grpc-js');
+            this.protoLoader = require('@grpc/proto-loader');
+        }
+        catch {
+            throw new Error('gRPC transport requires @grpc/grpc-js and @grpc/proto-loader as peer dependencies. ' +
+                'Install them: pnpm add @grpc/grpc-js @grpc/proto-loader');
+        }
+        this.loaded = true;
+    }
+    /**
+     * Load a `.proto` file and register all discovered service constructors.
+     *
+     * @param protoPath - Path to the `.proto` file. Falls back to {@link GrpcTransportConfig.protoPath}.
+     * @param packageName - Dot-separated package name. Falls back to {@link GrpcTransportConfig.packageName}.
+     * @throws {Error} If no proto path is provided or a package segment is missing.
+     * @since 1.0.0
+     */
+    loadProto(protoPath, packageName) {
+        this.ensureLoaded();
+        const path = protoPath ?? this.cfg.protoPath;
+        if (!path)
+            throw new Error('No protoPath provided');
+        const definition = this.protoLoader.loadSync(path, {
+            keepCase: true,
+            longs: String,
+            enums: String,
+            defaults: true,
+            oneofs: true
+        });
+        let root = this.grpc.loadPackageDefinition(definition);
+        const pkg = packageName ?? this.cfg.packageName;
+        if (pkg) {
+            for (const segment of pkg.split('.')) {
+                root = root[segment];
+                if (!root)
+                    throw new Error(`Package segment not found: ${segment}`);
+            }
+        }
+        // Register every service constructor found
+        for (const [name, value] of Object.entries(root)) {
+            if (typeof value === 'function' && value.service) {
+                this.services.set(name, value);
+            }
+        }
+    }
+    /**
+     * Get or create a gRPC service stub connected to the configured endpoint.
+     *
+     * @typeParam T - The expected service stub type.
+     * @param serviceName - Name of the service as defined in the `.proto` file.
+     * @returns A connected service stub instance.
+     * @throws {Error} If the service has not been loaded via {@link loadProto}.
+     * @since 1.0.0
+     */
+    getService(serviceName) {
+        this.ensureLoaded();
+        const Ctor = this.services.get(serviceName);
+        if (!Ctor)
+            throw new Error(`Service "${serviceName}" not loaded. Call loadProto() first.`);
+        const creds = this.cfg.tls
+            ? this.grpc.credentials.createSsl()
+            : this.grpc.credentials.createInsecure();
+        return new Ctor(this.cfg.endpoint, creds);
+    }
+    /**
+     * Execute a unary gRPC call wrapped in a promise.
+     *
+     * Automatically applies metadata and deadline from both the transport
+     * configuration and per-call options.
+     *
+     * @typeParam TReq - Request message type.
+     * @typeParam TRes - Response message type.
+     * @param service - The service stub obtained from {@link getService}.
+     * @param method - The RPC method name on the service.
+     * @param request - The request payload.
+     * @param opts - Optional per-call overrides for deadline and metadata.
+     * @returns A promise that resolves with the response message.
+     * @since 1.0.0
+     */
+    unary(service, method, request, opts = {}) {
+        this.ensureLoaded();
+        const fn = service[method];
+        if (typeof fn !== 'function') {
+            return Promise.reject(new Error(`Method "${method}" not found on service`));
+        }
+        const meta = new this.grpc.Metadata();
+        const allMeta = { ...this.cfg.metadata, ...opts.metadata };
+        for (const [k, v] of Object.entries(allMeta)) {
+            meta.set(k, v);
+        }
+        const deadline = opts.deadline ?? this.cfg.deadline;
+        const callOpts = deadline ? { deadline: Date.now() + deadline } : {};
+        return new Promise((resolve, reject) => {
+            fn.call(service, request, meta, callOpts, (err, res) => {
+                err ? reject(err) : resolve(res);
+            });
+        });
+    }
+    /**
+     * Clear all cached service stubs.
+     *
+     * @since 1.0.0
+     */
+    close() {
+        // Services are lightweight stubs; no explicit close needed.
+        this.services.clear();
+    }
+}
+exports.GrpcTransport = GrpcTransport;
+//# sourceMappingURL=transport.js.map

package/dist/cjs/grpc/transport.js.map

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

package/dist/cjs/grpc/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @module grpc/types
+ * @description gRPC transport types — optional peer dependency on `@grpc/grpc-js`.
+ * Defines configuration interfaces and type aliases for the gRPC transport layer.
+ * @since 1.0.0
+ */
+/**
+ * Configuration for initializing a {@link GrpcTransport} instance.
+ *
+ * @example
+ * ```ts
+ * const config: GrpcTransportConfig = {
+ *   endpoint: 'localhost:50051',
+ *   protoPath: './proto/geyser.proto',
+ *   packageName: 'geyser',
+ *   tls: false,
+ * };
+ * ```
+ * @since 1.0.0
+ */
+export interface GrpcTransportConfig {
+    endpoint: string;
+    /** Path to .proto file for custom services */
+    protoPath?: string;
+    /** Package name inside the proto definition */
+    packageName?: string;
+    /** If true, use TLS credentials (default: insecure) */
+    tls?: boolean;
+    /** Custom metadata sent with every call */
+    metadata?: Record<string, string>;
+    /** Deadline in ms for unary calls */
+    deadline?: number;
+}
+/**
+ * Per-call options for gRPC unary requests.
+ *
+ * @since 1.0.0
+ */
+export interface GrpcCallOptions {
+    deadline?: number;
+    metadata?: Record<string, string>;
+}
+/**
+ * Minimal gRPC unary method signature (callback-style).
+ *
+ * @typeParam TReq - The request message type.
+ * @typeParam TRes - The response message type.
+ * @since 1.0.0
+ */
+export type UnaryMethod<TReq, TRes> = (request: TReq, callback: (error: Error | null, response: TRes) => void) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/grpc/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/grpc/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,CAAC,IAAI,EAAE,IAAI,IAAI,CACpC,OAAO,EAAE,IAAI,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,KAAK,IAAI,KACpD,IAAI,CAAC"}

package/dist/cjs/grpc/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * @module grpc/types
+ * @description gRPC transport types — optional peer dependency on `@grpc/grpc-js`.
+ * Defines configuration interfaces and type aliases for the gRPC transport layer.
+ * @since 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/grpc/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/grpc/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/cjs/index.d.ts

@@ -1,31 +1,46 @@
-export { SynapseClient } from './client';
-export { SynapseUtils } from './utils/helpers';
-export * from './advanced/index';
-export * from './websocket/index';
-export { PDAManager, ZeroCombineFetcher, MerkleOperation, } from './ai/index';
-export type { PDAConfig, UserPDAs, ZeroChunk, SignatureInfo, ProofRecord, FetchConfig, ZeroCombineResult, MerkleLeaf, MerkleProof, MerkleValidationResult, ChunkInfo, InscriptionResult, OOBECompatibleAgent, AgentTradeSuggestion, AgentRiskReport, AgentAdapter, AIContext, AIResponse, TradeExecution, MultiChainSignal, AutoTradingStrategy, } from './ai/index';
-export * from './defi/index';
-export * from './nft/index';
-export * from './types';
-export type { PublicKey, Transaction, TransactionInstruction, Keypair, Signer, BlockhashWithExpiryBlockHeight, SimulatedTransactionResponse } from './types';
-import { SynapseClient } from './client';
-import { SynapseUtils } from './utils/helpers';
-import type { SynapseConfig } from './types';
-/**
- * @name Synapse
- * @description The main entry point for the Synapse SDK
- */
-export declare class Synapse {
-    client: SynapseClient;
-    utils: SynapseUtils;
-    constructor(config: SynapseConfig);
-}
 /**
- * Quick factory functions for developers
+ * @module @oobe-protocol-labs/synapse-client-sdk
+ *
+ * Enterprise Solana RPC Gateway SDK — Modular, typed, minimal.
+ *
+ * Provides typed access to 53 Solana JSON-RPC methods, WebSocket PubSub
+ * subscriptions, gRPC/Geyser streaming with parser, DAS (Digital Asset Standard)
+ * queries, AI agent tools with LangChain integration, and the x402 payment
+ * protocol. All modules are lazy-loaded and tree-shakeable.
+ *
+ * @since 1.0.0
+ * @see https://github.com/oobe-protocol-labs/synapse-client-sdk
+ *
+ * @example
+ * ```ts
+ * import { SynapseClient, Pubkey } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * const client = new SynapseClient({ endpoint: 'https://rpc.synapse.com' });
+ * const balance = await client.rpc.getBalance(Pubkey('So111…'));
+ * ```
  */
-export declare function createSynapseClient(endpoint: string, apiKey: string, debug?: boolean): Synapse;
+export * from './core/types';
+export * from './core/transport';
+export * from './core/client';
+export * from './core/errors';
+export * from './rpc/index';
+export * from './grpc/index';
+export * from './das/index';
+export * from './websocket/index';
+export * from './utils/index';
+export * from './kit/index';
+import { SynapseClient, type SynapseClientConfig } from './core/client';
 /**
- * Default export for easy imports
- */
-export default Synapse;
+ * Convenience factory to create a {@link SynapseClient} instance.
+ *
+ * @param config - Client configuration (endpoint, API key, etc.).
+ * @returns A configured `SynapseClient` instance.
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * const client = createSynapse({ endpoint: 'https://rpc.synapse.com', apiKey: 'sk-…' });
+ * ```
+ */ export declare function createSynapse(config: SynapseClientConfig): SynapseClient;
+export default SynapseClient;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,QAAQ,EACR,SAAS,EACT,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,sBAAsB,EACtB,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,YAAY,EAEZ,SAAS,EACT,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,cAAc,cAAc,CAAC;AAG7B,cAAc,aAAa,CAAC;AAG5B,cAAc,SAAS,CAAC;AAExB,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,EAAE,8BAA8B,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAK7J,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,qBAAa,OAAO;IACX,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;gBAEf,MAAM,EAAE,aAAa;CAQlC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAE5F;AAED;;GAEG;AACH,eAAe,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,cAAc,cAAc,CAAC;AAG7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,cAAc,cAAc,CAAC;AAG7B,cAAc,aAAa,CAAC;AAG5B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACxE;;;;;;;;;;;GAWG,CAAA,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CAE3E;AAED,eAAe,aAAa,CAAC"}

package/dist/cjs/index.js

@@ -1,4 +1,25 @@
 "use strict";
+/**
+ * @module @oobe-protocol-labs/synapse-client-sdk
+ *
+ * Enterprise Solana RPC Gateway SDK — Modular, typed, minimal.
+ *
+ * Provides typed access to 53 Solana JSON-RPC methods, WebSocket PubSub
+ * subscriptions, gRPC/Geyser streaming with parser, DAS (Digital Asset Standard)
+ * queries, AI agent tools with LangChain integration, and the x402 payment
+ * protocol. All modules are lazy-loaded and tree-shakeable.
+ *
+ * @since 1.0.0
+ * @see https://github.com/oobe-protocol-labs/synapse-client-sdk
+ *
+ * @example
+ * ```ts
+ * import { SynapseClient, Pubkey } from '@oobe-protocol-labs/synapse-client-sdk';
+ *
+ * const client = new SynapseClient({ endpoint: 'https://rpc.synapse.com' });
+ * const balance = await client.rpc.getBalance(Pubkey('So111…'));
+ * ```
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -14,58 +35,40 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Synapse = exports.MerkleOperation = exports.ZeroCombineFetcher = exports.PDAManager = exports.SynapseUtils = exports.SynapseClient = void 0;
-exports.createSynapseClient = createSynapseClient;
-// Core exports
-var client_1 = require("./client");
-Object.defineProperty(exports, "SynapseClient", { enumerable: true, get: function () { return client_1.SynapseClient; } });
-// TODO: SolanaRpcMethods uses deprecated 'call()' method - use SynapseClient direct methods instead
-// export { SolanaRpcMethods } from './methods/solana-rpc';
-var helpers_1 = require("./utils/helpers");
-Object.defineProperty(exports, "SynapseUtils", { enumerable: true, get: function () { return helpers_1.SynapseUtils; } });
-// Advanced enterprise features
-__exportStar(require("./advanced/index"), exports);
-// WebSocket real-time features  
+exports.createSynapse = createSynapse;
+// ── Solana-branded primitive types ──────────────────────────────
+__exportStar(require("./core/types"), exports);
+// ── Core transport & client ────────────────────────────────────
+__exportStar(require("./core/transport"), exports);
+__exportStar(require("./core/client"), exports);
+__exportStar(require("./core/errors"), exports);
+// ── JSON-RPC method modules (per-method files) ────────────────
+__exportStar(require("./rpc/index"), exports);
+// ── gRPC transport ─────────────────────────────────────────────
+__exportStar(require("./grpc/index"), exports);
+// ── DAS (Digital Asset Standard) NFT / cNFT module ─────────────
+__exportStar(require("./das/index"), exports);
+// ── WebSocket real-time subscriptions ──────────────────────────
 __exportStar(require("./websocket/index"), exports);
-// AI engines - Export AI modules separately to avoid type conflicts
-var index_1 = require("./ai/index");
-Object.defineProperty(exports, "PDAManager", { enumerable: true, get: function () { return index_1.PDAManager; } });
-Object.defineProperty(exports, "ZeroCombineFetcher", { enumerable: true, get: function () { return index_1.ZeroCombineFetcher; } });
-Object.defineProperty(exports, "MerkleOperation", { enumerable: true, get: function () { return index_1.MerkleOperation; } });
-// DeFi utilities
-__exportStar(require("./defi/index"), exports);
-// NFT & cNFT utilities
-__exportStar(require("./nft/index"), exports);
-// Types
-__exportStar(require("./types"), exports);
-// Supreme orchestrator
-// export { SynapseMasterClient } from './master-client';
-const client_2 = require("./client");
-const helpers_2 = require("./utils/helpers");
+// ── Utility helpers ────────────────────────────────────────────
+__exportStar(require("./utils/index"), exports);
+// ── @solana/kit bridge (native types, signers, RPC) ────────────
+__exportStar(require("./kit/index"), exports);
+// ── Convenience factory ────────────────────────────────────────
+const client_1 = require("./core/client");
 /**
- * @name Synapse
- * @description The main entry point for the Synapse SDK
- */
-class Synapse {
-    client;
-    utils;
-    constructor(config) {
-        this.client = new client_2.SynapseClient(config);
-        this.utils = new helpers_2.SynapseUtils(this.client);
-        if (config.debug) {
-            console.log(' Synapse SDK initialized successfully');
-        }
-    }
+ * Convenience factory to create a {@link SynapseClient} instance.
+ *
+ * @param config - Client configuration (endpoint, API key, etc.).
+ * @returns A configured `SynapseClient` instance.
+ * @since 1.0.0
+ *
+ * @example
+ * ```ts
+ * const client = createSynapse({ endpoint: 'https://rpc.synapse.com', apiKey: 'sk-…' });
+ * ```
+ */ function createSynapse(config) {
+    return new client_1.SynapseClient(config);
 }
-exports.Synapse = Synapse;
-/**
- * Quick factory functions for developers
- */
-function createSynapseClient(endpoint, apiKey, debug = false) {
-    return new Synapse({ endpoint, apiKey, debug });
-}
-/**
- * Default export for easy imports
- */
-exports.default = Synapse;
+exports.default = client_1.SynapseClient;
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAkFA,kDAEC;AApFD,eAAe;AACf,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AACtB,oGAAoG;AACpG,2DAA2D;AAC3D,2CAA+C;AAAtC,uGAAA,YAAY,OAAA;AAErB,+BAA+B;AAC/B,mDAAiC;AAEjC,iCAAiC;AACjC,oDAAkC;AAElC,oEAAoE;AACpE,oCAIoB;AAHlB,mGAAA,UAAU,OAAA;AACV,2GAAA,kBAAkB,OAAA;AAClB,wGAAA,eAAe,OAAA;AA2BjB,iBAAiB;AACjB,+CAA6B;AAE7B,uBAAuB;AACvB,8CAA4B;AAE5B,QAAQ;AACR,0CAAwB;AAIxB,uBAAuB;AACvB,yDAAyD;AAEzD,qCAAyC;AACzC,6CAA+C;AAG/C;;;GAGG;AACH,MAAa,OAAO;IACX,MAAM,CAAgB;IACtB,KAAK,CAAe;IAE3B,YAAY,MAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,sBAAa,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,IAAI,sBAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE3C,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF;AAZD,0BAYC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,QAAgB,EAAE,MAAc,EAAE,KAAK,GAAG,KAAK;IACjF,OAAO,IAAI,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,kBAAe,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAyCA,sCAEF;AAzCD,mEAAmE;AACnE,+CAA6B;AAE7B,kEAAkE;AAClE,mDAAiC;AACjC,gDAA8B;AAC9B,gDAA8B;AAE9B,iEAAiE;AACjE,8CAA4B;AAE5B,kEAAkE;AAClE,+CAA6B;AAE7B,kEAAkE;AAClE,8CAA4B;AAE5B,kEAAkE;AAClE,oDAAkC;AAElC,kEAAkE;AAClE,gDAA8B;AAE9B,kEAAkE;AAClE,8CAA4B;AAE5B,kEAAkE;AAClE,0CAAwE;AACxE;;;;;;;;;;;GAWG,CAAA,SAAgB,aAAa,CAAC,MAA2B;IAC1D,OAAO,IAAI,sBAAa,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,kBAAe,sBAAa,CAAC"}

package/dist/cjs/kit/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @solana/kit bridge — native Solana types, signers, and RPC for the Synapse SDK.
+ *
+ * This module re-exports curated types and functions from `@solana/kit` (the
+ * official Anza Solana TypeScript SDK) and provides bridge utilities to convert
+ * between Synapse branded types and Kit native types.
+ *
+ * @module kit
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { SynapseClient } from '@oobe-protocol-labs/synapse-client-sdk';
+ * import { toKitAddress, generateKeyPairSigner } from '@oobe-protocol-labs/synapse-client-sdk/kit';
+ *
+ * const client = new SynapseClient({ endpoint: 'https://rpc.synapse.com' });
+ *
+ * // Bridge Synapse Pubkey -> Kit Address
+ * const addr = toKitAddress(Pubkey('So11111111111111111111111111111111111111112'));
+ *
+ * // Use Kit's native RPC (fully typed 53 methods)
+ * const kitRpc = client.kitRpc;
+ * const balance = await kitRpc.getBalance(addr).send();
+ *
+ * // Generate a signer
+ * const signer = await generateKeyPairSigner();
+ * ```
+ */
+export type { Address } from '@solana/kit';
+export { address, isAddress, assertIsAddress, getAddressFromPublicKey, getAddressEncoder, getAddressDecoder, getAddressCodec, getAddressComparator, getProgramDerivedAddress, createAddressWithSeed, } from '@solana/kit';
+export type { SignatureBytes } from '@solana/kit';
+export { generateKeyPair, createKeyPairFromBytes, createKeyPairFromPrivateKeyBytes, signBytes, verifySignature, signature as kitSignature, isSignature as isKitSignature, assertIsSignature as assertIsKitSignature, } from '@solana/kit';
+export type { KeyPairSigner, TransactionSigner, MessageSigner, TransactionPartialSigner, MessagePartialSigner, NoopSigner, TransactionModifyingSigner, TransactionSendingSigner, } from '@solana/kit';
+export { generateKeyPairSigner, createKeyPairSignerFromBytes, createKeyPairSignerFromPrivateKeyBytes, createSignerFromKeyPair, createNoopSigner, isKeyPairSigner, assertIsKeyPairSigner, isTransactionSigner, assertIsTransactionSigner, addSignersToTransactionMessage, } from '@solana/kit';
+export type { Rpc, RpcTransport, SolanaRpcApi, SolanaRpcApiDevnet, SolanaRpcApiMainnet, SolanaRpcApiTestnet, } from '@solana/kit';
+export { createSolanaRpc, createSolanaRpcFromTransport, createSolanaRpcApi, createDefaultRpcTransport, createRpc, DEFAULT_RPC_CONFIG, } from '@solana/kit';
+export type { RpcSubscriptions, SolanaRpcSubscriptionsApi, } from '@solana/kit';
+export { createSolanaRpcSubscriptions, createSolanaRpcSubscriptions_UNSTABLE, createSolanaRpcSubscriptionsFromTransport, createSolanaRpcSubscriptionsApi, createDefaultRpcSubscriptionsTransport, createDefaultSolanaRpcSubscriptionsChannelCreator, DEFAULT_RPC_SUBSCRIPTIONS_CONFIG, } from '@solana/kit';
+export type { TransactionMessage, TransactionMessageWithBlockhashLifetime, } from '@solana/kit';
+export { createTransactionMessage, setTransactionMessageFeePayer, setTransactionMessageFeePayerSigner, setTransactionMessageLifetimeUsingBlockhash, setTransactionMessageLifetimeUsingDurableNonce, appendTransactionMessageInstruction, appendTransactionMessageInstructions, prependTransactionMessageInstruction, prependTransactionMessageInstructions, compileTransaction, compileTransactionMessage, signTransactionMessageWithSigners, partiallySignTransactionMessageWithSigners, signAndSendTransactionMessageWithSigners, partiallySignTransaction, signTransaction, pipe, } from '@solana/kit';
+export { sendAndConfirmTransactionFactory, sendAndConfirmDurableNonceTransactionFactory, sendTransactionWithoutConfirmingFactory, airdropFactory, } from '@solana/kit';
+export type { Commitment as KitCommitment } from '@solana/kit';
+export { lamports, blockhash, unixTimestamp as kitUnixTimestamp, commitmentComparator, } from '@solana/kit';
+export { devnet, mainnet, testnet, } from '@solana/kit';
+export { fetchEncodedAccount, fetchEncodedAccounts, fetchJsonParsedAccount, fetchJsonParsedAccounts, decodeAccount, parseBase58RpcAccount, parseBase64RpcAccount, parseJsonRpcAccount, assertAccountExists, assertAccountDecoded, } from '@solana/kit';
+export { AccountRole } from '@solana/kit';
+export { getBase58Encoder, getBase58Decoder, getBase58Codec, getBase64Encoder, getBase64Decoder, getBase64Codec, } from '@solana/kit';
+export { SolanaError } from '@solana/kit';
+export { createSignableMessage, } from '@solana/kit';
+import type { Address } from '@solana/kit';
+import type { Pubkey, Signature as SynapseSig, Lamports as SynapseLamports } from '../core/types';
+/**
+ * Convert a Synapse branded {@link Pubkey} to a Kit {@link Address}.
+ *
+ * @param pubkey - A Synapse `Pubkey` (base58 string).
+ * @returns A Kit `Address` with full type-level validation.
+ * @since 1.1.0
+ *
+ * @example
+ * ```ts
+ * import { Pubkey } from '@oobe-protocol-labs/synapse-client-sdk';
+ * import { toKitAddress } from '@oobe-protocol-labs/synapse-client-sdk/kit';
+ *
+ * const addr = toKitAddress(Pubkey('So11111111111111111111111111111111111111112'));
+ * ```
+ */
+export declare function toKitAddress(pubkey: Pubkey): Address;
+/**
+ * Convert a Kit {@link Address} to a Synapse branded {@link Pubkey}.
+ *
+ * @param addr - A Kit `Address`.
+ * @returns A Synapse `Pubkey`.
+ * @since 1.1.0
+ */
+export declare function fromKitAddress(addr: Address): Pubkey;
+/**
+ * Convert a Synapse branded {@link Signature} to a Kit signature string.
+ *
+ * @param sig - A Synapse `Signature` (base58 string).
+ * @returns The raw base58 string (Kit uses plain strings for tx signatures in RPC responses).
+ * @since 1.1.0
+ */
+export declare function toKitSignatureString(sig: SynapseSig): string;
+/**
+ * Convert a Synapse branded {@link Lamports} (bigint) to Kit lamports.
+ *
+ * Kit's `lamports()` factory produces an opaque branded bigint.
+ *
+ * @param amount - Synapse `Lamports` (bigint).
+ * @returns Kit-branded lamports value.
+ * @since 1.1.0
+ */
+export declare function toKitLamports(amount: SynapseLamports): import("@solana/kit").Lamports;
+//# sourceMappingURL=index.d.ts.map