@varity-labs/sdk 2.0.0-alpha.1

package/dist/modules/oracle/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Oracle Module - Exports
+ */
+export { OracleModule } from './OracleModule';
+export type { OracleQuery, OracleData, DataCallback, Subscription, PriceData, TimeRange, PriceHistory } from './OracleModule';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/oracle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/oracle/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,SAAS,EACT,YAAY,EACb,MAAM,gBAAgB,CAAA"}

package/dist/modules/oracle/index.js

@@ -0,0 +1,4 @@
+/**
+ * Oracle Module - Exports
+ */
+export { OracleModule } from './OracleModule';

package/dist/modules/storage/S3Module.d.ts

@@ -0,0 +1,377 @@
+/**
+ * Varity SDK - S3-Compatible Storage Module
+ *
+ * Provides S3-compatible methods backed by Filecoin/IPFS via S3 Gateway.
+ * Developers can use familiar S3 APIs (putObject, getObject, etc.) while
+ * benefiting from decentralized storage.
+ *
+ * @example
+ * ```typescript
+ * const sdk = new VaritySDK({
+ *   network: 'arbitrum-sepolia',
+ *   s3Config: {
+ *     endpoint: 'http://localhost:3001',
+ *     accessKeyId: 'test-key',
+ *     secretAccessKey: 'test-secret',
+ *     bucket: 'my-bucket',
+ *     region: 'us-east-1'
+ *   }
+ * })
+ *
+ * // Upload object
+ * const result = await sdk.s3.putObject({
+ *   Bucket: 'my-bucket',
+ *   Key: 'document.txt',
+ *   Body: 'Hello, World!'
+ * })
+ *
+ * // Download object
+ * const data = await sdk.s3.getObject({
+ *   Bucket: 'my-bucket',
+ *   Key: 'document.txt'
+ * })
+ * ```
+ */
+import type { VaritySDK } from '../../core/VaritySDK';
+import { type S3CompatibleConfig, type S3UploadResult, type S3ListObjectsResult, type S3PresignedUrl, type S3PresignedUrlOptions, type S3MultipartUpload, type S3MultipartUploadOptions, type S3UploadPart, type S3StorageClass } from '@varity-labs/types';
+/**
+ * S3 putObject parameters (S3-compatible API)
+ */
+export interface S3PutObjectParams {
+    /** Bucket name */
+    Bucket: string;
+    /** Object key */
+    Key: string;
+    /** Object content (Buffer, string, or Blob) */
+    Body: Buffer | string | Blob;
+    /** Content type */
+    ContentType?: string;
+    /** Content encoding */
+    ContentEncoding?: string;
+    /** Content language */
+    ContentLanguage?: string;
+    /** Cache control */
+    CacheControl?: string;
+    /** Content disposition */
+    ContentDisposition?: string;
+    /** Metadata */
+    Metadata?: Record<string, string>;
+    /** Tags */
+    Tagging?: string;
+    /** Storage class */
+    StorageClass?: S3StorageClass;
+    /** ACL */
+    ACL?: string;
+    /** Server-side encryption */
+    ServerSideEncryption?: 'AES256' | 'aws:kms';
+    /** KMS key ID */
+    SSEKMSKeyId?: string;
+}
+/**
+ * S3 getObject parameters (S3-compatible API)
+ */
+export interface S3GetObjectParams {
+    /** Bucket name */
+    Bucket: string;
+    /** Object key */
+    Key: string;
+    /** Range (e.g., 'bytes=0-1023') */
+    Range?: string;
+    /** Version ID */
+    VersionId?: string;
+    /** If-Match condition */
+    IfMatch?: string;
+    /** If-None-Match condition */
+    IfNoneMatch?: string;
+    /** If-Modified-Since condition */
+    IfModifiedSince?: Date;
+    /** If-Unmodified-Since condition */
+    IfUnmodifiedSince?: Date;
+}
+/**
+ * S3 getObject response (S3-compatible API)
+ */
+export interface S3GetObjectResponse {
+    /** Object body */
+    Body: Buffer;
+    /** Content type */
+    ContentType: string;
+    /** Content length */
+    ContentLength: number;
+    /** ETag */
+    ETag: string;
+    /** Last modified */
+    LastModified: Date;
+    /** Metadata */
+    Metadata?: Record<string, string>;
+    /** Version ID */
+    VersionId?: string;
+    /** Storage class */
+    StorageClass?: S3StorageClass;
+}
+/**
+ * S3 deleteObject parameters (S3-compatible API)
+ */
+export interface S3DeleteObjectParams {
+    /** Bucket name */
+    Bucket: string;
+    /** Object key */
+    Key: string;
+    /** Version ID */
+    VersionId?: string;
+}
+/**
+ * S3 listObjects parameters (S3-compatible API)
+ */
+export interface S3ListObjectsParams {
+    /** Bucket name */
+    Bucket: string;
+    /** Prefix filter */
+    Prefix?: string;
+    /** Delimiter */
+    Delimiter?: string;
+    /** Max keys to return */
+    MaxKeys?: number;
+    /** Continuation token */
+    ContinuationToken?: string;
+    /** Start after key */
+    StartAfter?: string;
+}
+/**
+ * S3 headObject parameters (S3-compatible API)
+ */
+export interface S3HeadObjectParams {
+    /** Bucket name */
+    Bucket: string;
+    /** Object key */
+    Key: string;
+    /** Version ID */
+    VersionId?: string;
+}
+/**
+ * S3 headObject response (S3-compatible API)
+ */
+export interface S3HeadObjectResponse {
+    /** Content type */
+    ContentType: string;
+    /** Content length */
+    ContentLength: number;
+    /** ETag */
+    ETag: string;
+    /** Last modified */
+    LastModified: Date;
+    /** Metadata */
+    Metadata?: Record<string, string>;
+    /** Version ID */
+    VersionId?: string;
+    /** Storage class */
+    StorageClass?: S3StorageClass;
+}
+/**
+ * S3Module - S3-Compatible Storage Interface
+ *
+ * Provides familiar S3 API methods backed by Filecoin/IPFS via S3 Gateway (Agent 2).
+ */
+export declare class S3Module {
+    private sdk;
+    private config;
+    constructor(sdk: VaritySDK, config: S3CompatibleConfig);
+    /**
+     * PUT object - S3-compatible upload
+     *
+     * @param params - PutObject parameters
+     * @returns Upload result with S3 metadata
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.s3.putObject({
+     *   Bucket: 'my-bucket',
+     *   Key: 'document.txt',
+     *   Body: 'Hello, World!',
+     *   ContentType: 'text/plain'
+     * })
+     * console.log(result.ETag)
+     * ```
+     */
+    putObject(params: S3PutObjectParams): Promise<S3UploadResult>;
+    /**
+     * GET object - S3-compatible download
+     *
+     * @param params - GetObject parameters
+     * @returns Object data and metadata
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.s3.getObject({
+     *   Bucket: 'my-bucket',
+     *   Key: 'document.txt'
+     * })
+     * console.log(result.Body.toString())
+     * ```
+     */
+    getObject(params: S3GetObjectParams): Promise<S3GetObjectResponse>;
+    /**
+     * DELETE object - S3-compatible deletion
+     *
+     * @param params - DeleteObject parameters
+     *
+     * @example
+     * ```typescript
+     * await sdk.s3.deleteObject({
+     *   Bucket: 'my-bucket',
+     *   Key: 'document.txt'
+     * })
+     * ```
+     */
+    deleteObject(params: S3DeleteObjectParams): Promise<void>;
+    /**
+     * LIST objects - S3-compatible list operation
+     *
+     * @param params - ListObjects parameters
+     * @returns List of objects
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.s3.listObjects({
+     *   Bucket: 'my-bucket',
+     *   Prefix: 'documents/'
+     * })
+     * console.log(result.objects.length)
+     * ```
+     */
+    listObjects(params: S3ListObjectsParams): Promise<S3ListObjectsResult>;
+    /**
+     * HEAD object - Get object metadata without downloading
+     *
+     * @param params - HeadObject parameters
+     * @returns Object metadata
+     *
+     * @example
+     * ```typescript
+     * const metadata = await sdk.s3.headObject({
+     *   Bucket: 'my-bucket',
+     *   Key: 'document.txt'
+     * })
+     * console.log(metadata.ContentLength)
+     * ```
+     */
+    headObject(params: S3HeadObjectParams): Promise<S3HeadObjectResponse>;
+    /**
+     * Generate presigned URL for object access
+     *
+     * @param bucket - Bucket name
+     * @param key - Object key
+     * @param options - Presigned URL options
+     * @returns Presigned URL
+     *
+     * @example
+     * ```typescript
+     * const presignedUrl = await sdk.s3.getPresignedUrl(
+     *   'my-bucket',
+     *   'document.txt',
+     *   { expiresIn: 3600, method: 'GET' }
+     * )
+     * console.log(presignedUrl.url)
+     * ```
+     */
+    getPresignedUrl(bucket: string, key: string, options: S3PresignedUrlOptions): Promise<S3PresignedUrl>;
+    /**
+     * Initiate multipart upload
+     *
+     * @param bucket - Bucket name
+     * @param key - Object key
+     * @param options - Multipart upload options
+     * @returns Upload session
+     */
+    createMultipartUpload(bucket: string, key: string, options?: S3MultipartUploadOptions): Promise<S3MultipartUpload>;
+    /**
+     * Upload part for multipart upload
+     *
+     * @param bucket - Bucket name
+     * @param key - Object key
+     * @param uploadId - Upload ID
+     * @param partNumber - Part number (1-10000)
+     * @param body - Part data
+     * @returns Upload part result
+     */
+    uploadPart(bucket: string, key: string, uploadId: string, partNumber: number, body: Buffer): Promise<S3UploadPart>;
+    /**
+     * Complete multipart upload
+     *
+     * @param bucket - Bucket name
+     * @param key - Object key
+     * @param uploadId - Upload ID
+     * @param parts - Uploaded parts
+     * @returns Upload result
+     */
+    completeMultipartUpload(bucket: string, key: string, uploadId: string, parts: S3UploadPart[]): Promise<S3UploadResult>;
+    /**
+     * Abort multipart upload
+     *
+     * @param bucket - Bucket name
+     * @param key - Object key
+     * @param uploadId - Upload ID
+     */
+    abortMultipartUpload(bucket: string, key: string, uploadId: string): Promise<void>;
+    /**
+     * Build endpoint URL
+     */
+    private buildEndpoint;
+    /**
+     * Build AWS Signature V4 headers
+     */
+    private buildAuthHeaders;
+    /**
+     * Get AMZ date (ISO 8601 format)
+     */
+    private getAmzDate;
+    /**
+     * Get credential scope
+     */
+    private getCredentialScope;
+    /**
+     * Build string to sign for presigned URL
+     */
+    private buildStringToSign;
+    /**
+     * Sign string using AWS Signature V4
+     */
+    private signString;
+    /**
+     * Get AWS Signature V4 signing key
+     */
+    private getSignatureKey;
+    /**
+     * Calculate SHA256 hash
+     */
+    private sha256;
+    /**
+     * Calculate SHA256 hash of buffer
+     */
+    private calculateSHA256;
+    /**
+     * Build metadata headers (x-amz-meta-*)
+     */
+    private buildMetadataHeaders;
+    /**
+     * Extract metadata from response headers
+     */
+    private extractMetadata;
+    /**
+     * Parse S3 ListObjectsV2 XML response
+     */
+    private parseListObjectsResponse;
+    /**
+     * Extract value from XML string
+     */
+    private extractXMLValue;
+    /**
+     * Extract upload ID from XML response
+     */
+    private extractUploadId;
+    /**
+     * Build CompleteMultipartUpload XML body
+     */
+    private buildCompleteMultipartUploadXML;
+}
+//# sourceMappingURL=S3Module.d.ts.map

package/dist/modules/storage/S3Module.d.ts.map

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