@robosystems/client 0.2.49 → 0.3.1

package/extensions/InvestorClient.d.ts

@@ -0,0 +1,98 @@
+import type { CreatePortfolioRequest, CreatePositionRequest, CreateSecurityRequest, UpdatePortfolioOperation, UpdatePositionOperation, UpdateSecurityOperation } from '../types.gen';
+import type { TokenProvider } from './graphql/client';
+import { type GetInvestorHoldingsQuery, type GetInvestorPortfolioQuery, type GetInvestorPositionQuery, type GetInvestorSecurityQuery, type ListInvestorPortfoliosQuery, type ListInvestorPositionsQuery, type ListInvestorSecuritiesQuery } from './graphql/generated/graphql';
+export type InvestorPortfolioList = NonNullable<ListInvestorPortfoliosQuery['portfolios']>;
+export type InvestorPortfolioSummary = InvestorPortfolioList['portfolios'][number];
+export type InvestorPortfolio = NonNullable<GetInvestorPortfolioQuery['portfolio']>;
+export type InvestorSecurityList = NonNullable<ListInvestorSecuritiesQuery['securities']>;
+export type InvestorSecuritySummary = InvestorSecurityList['securities'][number];
+export type InvestorSecurity = NonNullable<GetInvestorSecurityQuery['security']>;
+export type InvestorPositionList = NonNullable<ListInvestorPositionsQuery['positions']>;
+export type InvestorPositionSummary = InvestorPositionList['positions'][number];
+export type InvestorPosition = NonNullable<GetInvestorPositionQuery['position']>;
+export type InvestorHoldings = NonNullable<GetInvestorHoldingsQuery['holdings']>;
+export type InvestorEntityHolding = InvestorHoldings['holdings'][number];
+export type InvestorHeldSecurity = InvestorEntityHolding['securities'][number];
+interface InvestorClientConfig {
+    baseUrl: string;
+    credentials?: 'include' | 'same-origin' | 'omit';
+    headers?: Record<string, string>;
+    /** Static credential — use `tokenProvider` instead if the JWT rotates. */
+    token?: string;
+    /**
+     * Dynamic credential callback. When set, invoked on every GraphQL
+     * request so refreshes flow through automatically.
+     */
+    tokenProvider?: TokenProvider;
+}
+export declare class InvestorClient {
+    private config;
+    private gql;
+    constructor(config: InvestorClientConfig);
+    /** List portfolios with pagination. */
+    listPortfolios(graphId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<InvestorPortfolioList | null>;
+    /** Get a single portfolio by id. Returns null if it doesn't exist. */
+    getPortfolio(graphId: string, portfolioId: string): Promise<InvestorPortfolio | null>;
+    /** Create a new portfolio. Returns the created portfolio. */
+    createPortfolio(graphId: string, body: CreatePortfolioRequest): Promise<InvestorPortfolio>;
+    /** Update a portfolio's metadata. Only provided fields are applied. */
+    updatePortfolio(graphId: string, portfolioId: string, updates: Omit<UpdatePortfolioOperation, 'portfolio_id'>): Promise<InvestorPortfolio>;
+    /**
+     * Delete a portfolio. Fails with 409 if the portfolio still has active
+     * positions — dispose those first.
+     */
+    deletePortfolio(graphId: string, portfolioId: string): Promise<{
+        deleted: boolean;
+    }>;
+    /** List securities with pagination and filters. */
+    listSecurities(graphId: string, options?: {
+        entityId?: string;
+        securityType?: string;
+        isActive?: boolean;
+        limit?: number;
+        offset?: number;
+    }): Promise<InvestorSecurityList | null>;
+    /** Get a single security by id. Returns null if it doesn't exist. */
+    getSecurity(graphId: string, securityId: string): Promise<InvestorSecurity | null>;
+    /**
+     * Create a new security. Passing `source_graph_id` auto-links to the
+     * matching entity in the target graph.
+     */
+    createSecurity(graphId: string, body: CreateSecurityRequest): Promise<InvestorSecurity>;
+    /** Update a security's metadata. Only provided fields are applied. */
+    updateSecurity(graphId: string, securityId: string, updates: Omit<UpdateSecurityOperation, 'security_id'>): Promise<InvestorSecurity>;
+    /** Soft-delete a security (sets is_active=false). */
+    deleteSecurity(graphId: string, securityId: string): Promise<{
+        deleted: boolean;
+    }>;
+    /** List positions with pagination and filters. */
+    listPositions(graphId: string, options?: {
+        portfolioId?: string;
+        securityId?: string;
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<InvestorPositionList | null>;
+    /** Get a single position by id. Returns null if it doesn't exist. */
+    getPosition(graphId: string, positionId: string): Promise<InvestorPosition | null>;
+    /** Create a new position. */
+    createPosition(graphId: string, body: CreatePositionRequest): Promise<InvestorPosition>;
+    /** Update a position. Only provided fields are applied. */
+    updatePosition(graphId: string, positionId: string, updates: Omit<UpdatePositionOperation, 'position_id'>): Promise<InvestorPosition>;
+    /** Delete (dispose) a position. */
+    deletePosition(graphId: string, positionId: string): Promise<{
+        deleted: boolean;
+    }>;
+    /**
+     * Get portfolio holdings grouped by entity. Returns the full list of
+     * securities held and aggregate cost-basis / current-value for each
+     * entity in the portfolio.
+     */
+    getHoldings(graphId: string, portfolioId: string): Promise<InvestorHoldings | null>;
+    private gqlQuery;
+    private callOperation;
+}
+export {};

package/extensions/InvestorClient.js

@@ -0,0 +1,223 @@
+'use client';
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvestorClient = void 0;
+const graphql_request_1 = require("graphql-request");
+const sdk_gen_1 = require("../sdk.gen");
+const client_1 = require("./graphql/client");
+const graphql_1 = require("./graphql/generated/graphql");
+class InvestorClient {
+    constructor(config) {
+        this.config = config;
+        this.gql = new client_1.GraphQLClientCache(config);
+    }
+    // ── Portfolios ──────────────────────────────────────────────────────
+    /** List portfolios with pagination. */
+    async listPortfolios(graphId, options) {
+        return this.gqlQuery(graphId, graphql_1.ListInvestorPortfoliosDocument, {
+            limit: options?.limit ?? 100,
+            offset: options?.offset ?? 0,
+        }, 'List portfolios', (data) => data.portfolios);
+    }
+    /** Get a single portfolio by id. Returns null if it doesn't exist. */
+    async getPortfolio(graphId, portfolioId) {
+        return this.gqlQuery(graphId, graphql_1.GetInvestorPortfolioDocument, { portfolioId }, 'Get portfolio', (data) => data.portfolio);
+    }
+    /** Create a new portfolio. Returns the created portfolio. */
+    async createPortfolio(graphId, body) {
+        const envelope = await this.callOperation('Create portfolio', (0, sdk_gen_1.opCreatePortfolio)({ path: { graph_id: graphId }, body }));
+        return rawToInvestorPortfolio(envelope.result);
+    }
+    /** Update a portfolio's metadata. Only provided fields are applied. */
+    async updatePortfolio(graphId, portfolioId, updates) {
+        const envelope = await this.callOperation('Update portfolio', (0, sdk_gen_1.opUpdatePortfolio)({
+            path: { graph_id: graphId },
+            body: {
+                ...updates,
+                portfolio_id: portfolioId,
+            },
+        }));
+        return rawToInvestorPortfolio(envelope.result);
+    }
+    /**
+     * Delete a portfolio. Fails with 409 if the portfolio still has active
+     * positions — dispose those first.
+     */
+    async deletePortfolio(graphId, portfolioId) {
+        const envelope = await this.callOperation('Delete portfolio', (0, sdk_gen_1.opDeletePortfolio)({
+            path: { graph_id: graphId },
+            body: { portfolio_id: portfolioId },
+        }));
+        return (envelope.result ?? { deleted: true });
+    }
+    // ── Securities ──────────────────────────────────────────────────────
+    /** List securities with pagination and filters. */
+    async listSecurities(graphId, options) {
+        return this.gqlQuery(graphId, graphql_1.ListInvestorSecuritiesDocument, {
+            entityId: options?.entityId ?? null,
+            securityType: options?.securityType ?? null,
+            isActive: options?.isActive ?? null,
+            limit: options?.limit ?? 100,
+            offset: options?.offset ?? 0,
+        }, 'List securities', (data) => data.securities);
+    }
+    /** Get a single security by id. Returns null if it doesn't exist. */
+    async getSecurity(graphId, securityId) {
+        return this.gqlQuery(graphId, graphql_1.GetInvestorSecurityDocument, { securityId }, 'Get security', (data) => data.security);
+    }
+    /**
+     * Create a new security. Passing `source_graph_id` auto-links to the
+     * matching entity in the target graph.
+     */
+    async createSecurity(graphId, body) {
+        const envelope = await this.callOperation('Create security', (0, sdk_gen_1.opCreateSecurity)({ path: { graph_id: graphId }, body }));
+        return rawToInvestorSecurity(envelope.result);
+    }
+    /** Update a security's metadata. Only provided fields are applied. */
+    async updateSecurity(graphId, securityId, updates) {
+        const envelope = await this.callOperation('Update security', (0, sdk_gen_1.opUpdateSecurity)({
+            path: { graph_id: graphId },
+            body: {
+                ...updates,
+                security_id: securityId,
+            },
+        }));
+        return rawToInvestorSecurity(envelope.result);
+    }
+    /** Soft-delete a security (sets is_active=false). */
+    async deleteSecurity(graphId, securityId) {
+        const envelope = await this.callOperation('Delete security', (0, sdk_gen_1.opDeleteSecurity)({
+            path: { graph_id: graphId },
+            body: { security_id: securityId },
+        }));
+        return (envelope.result ?? { deleted: true });
+    }
+    // ── Positions ───────────────────────────────────────────────────────
+    /** List positions with pagination and filters. */
+    async listPositions(graphId, options) {
+        return this.gqlQuery(graphId, graphql_1.ListInvestorPositionsDocument, {
+            portfolioId: options?.portfolioId ?? null,
+            securityId: options?.securityId ?? null,
+            status: options?.status ?? null,
+            limit: options?.limit ?? 100,
+            offset: options?.offset ?? 0,
+        }, 'List positions', (data) => data.positions);
+    }
+    /** Get a single position by id. Returns null if it doesn't exist. */
+    async getPosition(graphId, positionId) {
+        return this.gqlQuery(graphId, graphql_1.GetInvestorPositionDocument, { positionId }, 'Get position', (data) => data.position);
+    }
+    /** Create a new position. */
+    async createPosition(graphId, body) {
+        const envelope = await this.callOperation('Create position', (0, sdk_gen_1.opCreatePosition)({ path: { graph_id: graphId }, body }));
+        return rawToInvestorPosition(envelope.result);
+    }
+    /** Update a position. Only provided fields are applied. */
+    async updatePosition(graphId, positionId, updates) {
+        const envelope = await this.callOperation('Update position', (0, sdk_gen_1.opUpdatePosition)({
+            path: { graph_id: graphId },
+            body: {
+                ...updates,
+                position_id: positionId,
+            },
+        }));
+        return rawToInvestorPosition(envelope.result);
+    }
+    /** Delete (dispose) a position. */
+    async deletePosition(graphId, positionId) {
+        const envelope = await this.callOperation('Delete position', (0, sdk_gen_1.opDeletePosition)({
+            path: { graph_id: graphId },
+            body: { position_id: positionId },
+        }));
+        return (envelope.result ?? { deleted: true });
+    }
+    // ── Holdings (aggregation) ─────────────────────────────────────────
+    /**
+     * Get portfolio holdings grouped by entity. Returns the full list of
+     * securities held and aggregate cost-basis / current-value for each
+     * entity in the portfolio.
+     */
+    async getHoldings(graphId, portfolioId) {
+        return this.gqlQuery(graphId, graphql_1.GetInvestorHoldingsDocument, { portfolioId }, 'Get holdings', (data) => data.holdings);
+    }
+    // ── Internal helpers ────────────────────────────────────────────────
+    async gqlQuery(graphId, document, variables, label, pick) {
+        try {
+            const client = this.gql.get(graphId);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const raw = client.request;
+            const data = (await raw.call(client, document, variables));
+            return pick(data);
+        }
+        catch (err) {
+            if (err instanceof graphql_request_1.ClientError) {
+                throw new Error(`${label} failed: ${JSON.stringify(err.response.errors ?? err.message)}`);
+            }
+            throw err;
+        }
+    }
+    async callOperation(label, call) {
+        const response = await call;
+        if (response.error !== undefined) {
+            throw new Error(`${label} failed: ${JSON.stringify(response.error)}`);
+        }
+        if (response.data === undefined) {
+            throw new Error(`${label} failed: empty response`);
+        }
+        return response.data;
+    }
+}
+exports.InvestorClient = InvestorClient;
+function rawToInvestorPortfolio(raw) {
+    return {
+        id: raw.id,
+        name: raw.name,
+        description: raw.description,
+        strategy: raw.strategy,
+        inceptionDate: raw.inception_date,
+        baseCurrency: raw.base_currency,
+        createdAt: raw.created_at,
+        updatedAt: raw.updated_at,
+    };
+}
+function rawToInvestorSecurity(raw) {
+    return {
+        id: raw.id,
+        entityId: raw.entity_id,
+        entityName: raw.entity_name,
+        sourceGraphId: raw.source_graph_id,
+        name: raw.name,
+        securityType: raw.security_type,
+        securitySubtype: raw.security_subtype,
+        terms: raw.terms,
+        isActive: raw.is_active,
+        authorizedShares: raw.authorized_shares,
+        outstandingShares: raw.outstanding_shares,
+        createdAt: raw.created_at,
+        updatedAt: raw.updated_at,
+    };
+}
+function rawToInvestorPosition(raw) {
+    return {
+        id: raw.id,
+        portfolioId: raw.portfolio_id,
+        securityId: raw.security_id,
+        securityName: raw.security_name,
+        entityName: raw.entity_name,
+        quantity: raw.quantity,
+        quantityType: raw.quantity_type,
+        costBasis: raw.cost_basis,
+        costBasisDollars: raw.cost_basis_dollars,
+        currency: raw.currency,
+        currentValue: raw.current_value,
+        currentValueDollars: raw.current_value_dollars,
+        valuationDate: raw.valuation_date,
+        valuationSource: raw.valuation_source,
+        acquisitionDate: raw.acquisition_date,
+        dispositionDate: raw.disposition_date,
+        status: raw.status,
+        notes: raw.notes,
+        createdAt: raw.created_at,
+        updatedAt: raw.updated_at,
+    };
+}