@vtriv/sdk 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,73 @@
+/**
+ * vtriv SDK - Main Client
+ *
+ * Unified client for all vtriv services with three modes:
+ * - Admin: Root/Account key for management
+ * - Backend: API key for minting tokens
+ * - Frontend: JWT tokens for user operations
+ */
+import { AiService } from "./services/ai.js";
+import { AuthService } from "./services/auth.js";
+import { BlobService } from "./services/blob.js";
+import { CronService } from "./services/cron.js";
+import { DbService } from "./services/db.js";
+import { SearchService } from "./services/search.js";
+import type { TokenPair, VtrivConfig } from "./types.js";
+export interface ServiceUrls {
+    auth?: string;
+    db?: string;
+    blob?: string;
+    search?: string;
+    ai?: string;
+    cron?: string;
+}
+export declare class VtrivClient {
+    private config;
+    private tokenManager;
+    private ctx;
+    private serviceUrls;
+    private _auth;
+    private _db;
+    private _blob;
+    private _search;
+    private _ai;
+    private _cron;
+    constructor(config: VtrivConfig, serviceUrls?: ServiceUrls);
+    /**
+     * Get the authorization header based on mode
+     */
+    private getAuthHeader;
+    /**
+     * Get the project name (for backend/frontend modes)
+     */
+    private get project();
+    /** Auth service for authentication and user management */
+    get auth(): AuthService;
+    /** Database service for document operations */
+    get db(): DbService;
+    /** Blob service for file storage */
+    get blob(): BlobService;
+    /** Search service for vector/semantic search */
+    get search(): SearchService;
+    /** AI service for completions and embeddings */
+    get ai(): AiService;
+    /** Cron service for scheduled jobs */
+    get cron(): CronService;
+    /**
+     * Set tokens (for frontend mode after login/register)
+     */
+    setTokens(tokens: TokenPair): void;
+    /**
+     * Clear tokens (logout)
+     */
+    clearTokens(): void;
+    /**
+     * Check if authenticated (has tokens)
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get current access token (for frontend mode)
+     */
+    getAccessToken(): string | null;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EACX,SAAS,EAIT,WAAW,EACX,MAAM,YAAY,CAAC;AAwBpB,MAAM,WAAW,WAAW;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAMD,qBAAa,WAAW;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,WAAW,CAAc;IAGjC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,KAAK,CAA4B;gBAE7B,MAAM,EAAE,WAAW,EAAE,WAAW,GAAE,WAAgB;IA2B9D;;OAEG;YACW,aAAa;IAqB3B;;OAEG;IACH,OAAO,KAAK,OAAO,GAKlB;IAMD,0DAA0D;IAC1D,IAAI,IAAI,IAAI,WAAW,CAStB;IAED,+CAA+C;IAC/C,IAAI,EAAE,IAAI,SAAS,CAYlB;IAED,oCAAoC;IACpC,IAAI,IAAI,IAAI,WAAW,CAYtB;IAED,gDAAgD;IAChD,IAAI,MAAM,IAAI,aAAa,CAY1B;IAED,gDAAgD;IAChD,IAAI,EAAE,IAAI,SAAS,CAOlB;IAED,sCAAsC;IACtC,IAAI,IAAI,IAAI,WAAW,CAYtB;IAMD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAOlC;;OAEG;IACH,WAAW,IAAI,IAAI;IAMnB;;OAEG;IACH,eAAe,IAAI,OAAO;IAO1B;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;CAG/B"}

package/dist/errors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * vtriv SDK - Error Classes
+ */
+import type { ErrorResponse } from "./types.js";
+/** Base error class for all vtriv errors */
+export declare class VtrivError extends Error {
+    readonly code?: string;
+    readonly details?: unknown;
+    readonly status?: number;
+    constructor(message: string, options?: {
+        code?: string;
+        details?: unknown;
+        status?: number;
+    });
+    static fromResponse(response: ErrorResponse, status?: number): VtrivError;
+}
+/** Authentication error (401) */
+export declare class AuthenticationError extends VtrivError {
+    constructor(message?: string);
+}
+/** Authorization error (403) */
+export declare class AuthorizationError extends VtrivError {
+    constructor(message?: string);
+}
+/** Not found error (404) */
+export declare class NotFoundError extends VtrivError {
+    constructor(message?: string);
+}
+/** Validation error (400) */
+export declare class ValidationError extends VtrivError {
+    constructor(message: string, details?: unknown);
+}
+/** Rate limit error (429 or 402) */
+export declare class RateLimitError extends VtrivError {
+    constructor(message?: string);
+}
+/** Network error (connection failed, timeout, etc.) */
+export declare class NetworkError extends VtrivError {
+    constructor(message?: string, cause?: Error);
+}
+/** Token expired error - triggers refresh */
+export declare class TokenExpiredError extends VtrivError {
+    constructor();
+}
+/** Map HTTP status to appropriate error class */
+export declare function createErrorFromStatus(status: number, response: ErrorResponse): VtrivError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,4CAA4C;AAC5C,qBAAa,UAAW,SAAQ,KAAK;IACpC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAQ5F,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU;CAOzE;AAED,iCAAiC;AACjC,qBAAa,mBAAoB,SAAQ,UAAU;gBACtC,OAAO,SAA4B;CAI/C;AAED,gCAAgC;AAChC,qBAAa,kBAAmB,SAAQ,UAAU;gBACrC,OAAO,SAAmB;CAItC;AAED,4BAA4B;AAC5B,qBAAa,aAAc,SAAQ,UAAU;gBAChC,OAAO,SAAuB;CAI1C;AAED,6BAA6B;AAC7B,qBAAa,eAAgB,SAAQ,UAAU;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI9C;AAED,oCAAoC;AACpC,qBAAa,cAAe,SAAQ,UAAU;gBACjC,OAAO,SAAwB;CAI3C;AAED,uDAAuD;AACvD,qBAAa,YAAa,SAAQ,UAAU;gBAC/B,OAAO,SAA2B,EAAE,KAAK,CAAC,EAAE,KAAK;CAK7D;AAED,6CAA6C;AAC7C,qBAAa,iBAAkB,SAAQ,UAAU;;CAKhD;AAED,iDAAiD;AACjD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,UAAU,CAgBzF"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * vtriv SDK
+ *
+ * TypeScript SDK for vtriv services
+ */
+export { type ServiceUrls, VtrivClient } from "./client.js";
+export { AuthenticationError, AuthorizationError, NetworkError, NotFoundError, RateLimitError, TokenExpiredError, ValidationError, VtrivError, } from "./errors.js";
+export { AiService } from "./services/ai.js";
+export { AuthService } from "./services/auth.js";
+export { BlobService } from "./services/blob.js";
+export { CronService } from "./services/cron.js";
+export { type CollectionApi, DbService } from "./services/db.js";
+export { type IndexApi, SearchService } from "./services/search.js";
+export type { Account, AccountCreateResponse, AccountWithProjects, AiConfig, ApiKey, ApiKeyCreateResponse, BatchOperation, BatchResult, ChatCompletionChunk, ChatCompletionRequest, ChatCompletionResponse, ChatMessage, CollectionSchema, CreateUserData, CronJob, CronJobWithKey, Document, EmbeddingRequest, EmbeddingResponse, ErrorResponse, IndexConfig, JobRun, ListOptions, ListResponse, LoginCredentials, MintTokenRequest, OkResponse, PresignedUrlResponse, ProjectConfig, RegisterData, SearchDocument, SearchOptions, SearchResult, TokenPair, UpdateUserData, UploadResponse, UsageStats, User, VtrivAdminConfig, VtrivBackendConfig, VtrivClientConfig, VtrivConfig, } from "./types.js";
+export { decodeJwt, getTokenExpiresIn, isTokenExpired, TokenManager, } from "./utils/token.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EACN,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,UAAU,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,KAAK,aAAa,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,KAAK,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEpE,YAAY,EACX,OAAO,EACP,qBAAqB,EACrB,mBAAmB,EACnB,QAAQ,EACR,MAAM,EACN,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EAEtB,WAAW,EACX,gBAAgB,EAChB,cAAc,EAEd,OAAO,EACP,cAAc,EAEd,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EAEb,WAAW,EACX,MAAM,EACN,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAEhB,UAAU,EACV,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EAEZ,SAAS,EACT,cAAc,EAEd,cAAc,EACd,UAAU,EACV,IAAI,EAEJ,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EACN,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,YAAY,GACZ,MAAM,kBAAkB,CAAC"}