cas-parser-node 1.4.1 → 1.6.2

package/src/resources/inbox.ts

@@ -0,0 +1,283 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+
+export class Inbox extends APIResource {
+  /**
+   * Verify if an `inbox_token` is still valid and check connection status.
+   *
+   * Use this to check if the user needs to re-authenticate (e.g., if they revoked
+   * access in their email provider settings).
+   *
+   * @example
+   * ```ts
+   * const response = await client.inbox.checkConnectionStatus({
+   *   'x-inbox-token': 'x-inbox-token',
+   * });
+   * ```
+   */
+  checkConnectionStatus(
+    params: InboxCheckConnectionStatusParams,
+    options?: RequestOptions,
+  ): APIPromise<InboxCheckConnectionStatusResponse> {
+    const { 'x-inbox-token': xInboxToken } = params;
+    return this._client.post('/v4/inbox/status', {
+      ...options,
+      headers: buildHeaders([{ 'x-inbox-token': xInboxToken }, options?.headers]),
+    });
+  }
+
+  /**
+   * Initiate OAuth flow to connect user's email inbox.
+   *
+   * Returns an `oauth_url` that you should redirect the user to. After
+   * authorization, they are redirected back to your `redirect_uri` with the
+   * following query parameters:
+   *
+   * **On success:**
+   *
+   * - `inbox_token` - Encrypted token to store client-side
+   * - `email` - Email address of the connected account
+   * - `state` - Your original state parameter (for CSRF verification)
+   *
+   * **On error:**
+   *
+   * - `error` - Error code (e.g., `access_denied`, `token_exchange_failed`)
+   * - `state` - Your original state parameter
+   *
+   * **Store the `inbox_token` client-side** and use it for all subsequent inbox API
+   * calls.
+   *
+   * @example
+   * ```ts
+   * const response = await client.inbox.connectEmail({
+   *   redirect_uri: 'https://yourapp.com/oauth-callback',
+   * });
+   * ```
+   */
+  connectEmail(
+    body: InboxConnectEmailParams,
+    options?: RequestOptions,
+  ): APIPromise<InboxConnectEmailResponse> {
+    return this._client.post('/v4/inbox/connect', { body, ...options });
+  }
+
+  /**
+   * Revoke email access and invalidate the token.
+   *
+   * This calls the provider's token revocation API (e.g., Google's revoke endpoint)
+   * to ensure the user's consent is properly removed.
+   *
+   * After calling this, the `inbox_token` becomes unusable.
+   *
+   * @example
+   * ```ts
+   * const response = await client.inbox.disconnectEmail({
+   *   'x-inbox-token': 'x-inbox-token',
+   * });
+   * ```
+   */
+  disconnectEmail(
+    params: InboxDisconnectEmailParams,
+    options?: RequestOptions,
+  ): APIPromise<InboxDisconnectEmailResponse> {
+    const { 'x-inbox-token': xInboxToken } = params;
+    return this._client.post('/v4/inbox/disconnect', {
+      ...options,
+      headers: buildHeaders([{ 'x-inbox-token': xInboxToken }, options?.headers]),
+    });
+  }
+
+  /**
+   * Search the user's email inbox for CAS files from known senders (CAMS, KFintech,
+   * CDSL, NSDL).
+   *
+   * Files are uploaded to temporary cloud storage. **URLs expire in 24 hours.**
+   *
+   * Optionally filter by CAS provider and date range.
+   *
+   * **Billing:** 0.2 credits per request (charged regardless of success or number of
+   * files found).
+   *
+   * @example
+   * ```ts
+   * const response = await client.inbox.listCasFiles({
+   *   'x-inbox-token': 'x-inbox-token',
+   * });
+   * ```
+   */
+  listCasFiles(
+    params: InboxListCasFilesParams,
+    options?: RequestOptions,
+  ): APIPromise<InboxListCasFilesResponse> {
+    const { 'x-inbox-token': xInboxToken, ...body } = params;
+    return this._client.post('/v4/inbox/cas', {
+      body,
+      ...options,
+      headers: buildHeaders([{ 'x-inbox-token': xInboxToken }, options?.headers]),
+    });
+  }
+}
+
+export interface InboxCheckConnectionStatusResponse {
+  /**
+   * Whether the token is valid and usable
+   */
+  connected?: boolean;
+
+  /**
+   * Email address of the connected account
+   */
+  email?: string;
+
+  provider?: string;
+
+  status?: string;
+}
+
+export interface InboxConnectEmailResponse {
+  /**
+   * Seconds until the OAuth URL expires (typically 10 minutes)
+   */
+  expires_in?: number;
+
+  /**
+   * Redirect user to this URL to start OAuth flow
+   */
+  oauth_url?: string;
+
+  status?: string;
+}
+
+export interface InboxDisconnectEmailResponse {
+  msg?: string;
+
+  status?: string;
+}
+
+export interface InboxListCasFilesResponse {
+  /**
+   * Number of CAS files found
+   */
+  count?: number;
+
+  files?: Array<InboxListCasFilesResponse.File>;
+
+  status?: string;
+}
+
+export namespace InboxListCasFilesResponse {
+  /**
+   * A CAS file found in the user's email inbox
+   */
+  export interface File {
+    /**
+     * Detected CAS provider based on sender email
+     */
+    cas_type?: 'cdsl' | 'nsdl' | 'cams' | 'kfintech';
+
+    /**
+     * URL expiration time in seconds (default 86400 = 24 hours)
+     */
+    expires_in?: number;
+
+    /**
+     * Standardized filename (provider_YYYYMMDD_uniqueid.pdf)
+     */
+    filename?: string;
+
+    /**
+     * Date the email was received
+     */
+    message_date?: string;
+
+    /**
+     * Unique identifier for the email message (use for subsequent API calls)
+     */
+    message_id?: string;
+
+    /**
+     * Original attachment filename from the email
+     */
+    original_filename?: string;
+
+    /**
+     * File size in bytes
+     */
+    size?: number;
+
+    /**
+     * Direct download URL (presigned, expires based on expires_in)
+     */
+    url?: string;
+  }
+}
+
+export interface InboxCheckConnectionStatusParams {
+  /**
+   * The encrypted inbox token
+   */
+  'x-inbox-token': string;
+}
+
+export interface InboxConnectEmailParams {
+  /**
+   * Your callback URL to receive the inbox_token (must be http or https)
+   */
+  redirect_uri: string;
+
+  /**
+   * State parameter for CSRF protection (returned in redirect)
+   */
+  state?: string;
+}
+
+export interface InboxDisconnectEmailParams {
+  /**
+   * The encrypted inbox token to revoke
+   */
+  'x-inbox-token': string;
+}
+
+export interface InboxListCasFilesParams {
+  /**
+   * Header param: The encrypted inbox token
+   */
+  'x-inbox-token': string;
+
+  /**
+   * Body param: Filter by CAS provider(s):
+   *
+   * - `cdsl` → eCAS@cdslstatement.com
+   * - `nsdl` → NSDL-CAS@nsdl.co.in
+   * - `cams` → donotreply@camsonline.com
+   * - `kfintech` → samfS@kfintech.com
+   */
+  cas_types?: Array<'cdsl' | 'nsdl' | 'cams' | 'kfintech'>;
+
+  /**
+   * Body param: End date in ISO format (YYYY-MM-DD). Defaults to today.
+   */
+  end_date?: string;
+
+  /**
+   * Body param: Start date in ISO format (YYYY-MM-DD). Defaults to 30 days ago.
+   */
+  start_date?: string;
+}
+
+export declare namespace Inbox {
+  export {
+    type InboxCheckConnectionStatusResponse as InboxCheckConnectionStatusResponse,
+    type InboxConnectEmailResponse as InboxConnectEmailResponse,
+    type InboxDisconnectEmailResponse as InboxDisconnectEmailResponse,
+    type InboxListCasFilesResponse as InboxListCasFilesResponse,
+    type InboxCheckConnectionStatusParams as InboxCheckConnectionStatusParams,
+    type InboxConnectEmailParams as InboxConnectEmailParams,
+    type InboxDisconnectEmailParams as InboxDisconnectEmailParams,
+    type InboxListCasFilesParams as InboxListCasFilesParams,
+  };
+}

package/src/resources/index.ts

@@ -1,15 +1,35 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export { AccessToken, type AccessTokenCreateResponse, type AccessTokenCreateParams } from './access-token';
 export {
-  CasGenerator,
-  type CasGeneratorGenerateCasResponse,
-  type CasGeneratorGenerateCasParams,
-} from './cas-generator';
-export {
-  CasParserResource,
+  CamsKfintech,
+  type LinkedHolder,
+  type Transaction,
   type UnifiedResponse,
-  type CasParserCamsKfintechParams,
-  type CasParserCdslParams,
-  type CasParserNsdlParams,
-  type CasParserSmartParseParams,
-} from './cas-parser';
+  type CamsKfintechParseParams,
+} from './cams-kfintech';
+export { Cdsl, type CdslParsePdfParams } from './cdsl/cdsl';
+export { ContractNote, type ContractNoteParseResponse, type ContractNoteParseParams } from './contract-note';
+export { Credits, type CreditCheckResponse } from './credits';
+export {
+  Inbox,
+  type InboxCheckConnectionStatusResponse,
+  type InboxConnectEmailResponse,
+  type InboxDisconnectEmailResponse,
+  type InboxListCasFilesResponse,
+  type InboxCheckConnectionStatusParams,
+  type InboxConnectEmailParams,
+  type InboxDisconnectEmailParams,
+  type InboxListCasFilesParams,
+} from './inbox';
+export { Kfintech, type KfintechGenerateCasResponse, type KfintechGenerateCasParams } from './kfintech';
+export {
+  Logs,
+  type LogCreateResponse,
+  type LogGetSummaryResponse,
+  type LogCreateParams,
+  type LogGetSummaryParams,
+} from './logs';
+export { Nsdl, type NsdlParseParams } from './nsdl';
+export { Smart, type SmartParseCasPdfParams } from './smart';
+export { VerifyToken, type VerifyTokenVerifyResponse } from './verify-token';

package/src/resources/kfintech.ts

@@ -0,0 +1,71 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class Kfintech extends APIResource {
+  /**
+   * Generate CAS via KFintech mailback. The CAS PDF will be sent to the investor's
+   * email.
+   *
+   * This is an async operation - the investor receives the CAS via email within a
+   * few minutes. For instant CAS retrieval, use CDSL Fetch (`/v4/cdsl/fetch`).
+   *
+   * @example
+   * ```ts
+   * const response = await client.kfintech.generateCas({
+   *   email: 'user@example.com',
+   *   from_date: '2023-01-01',
+   *   password: 'Abcdefghi12$',
+   *   to_date: '2023-12-31',
+   * });
+   * ```
+   */
+  generateCas(
+    body: KfintechGenerateCasParams,
+    options?: RequestOptions,
+  ): APIPromise<KfintechGenerateCasResponse> {
+    return this._client.post('/v4/kfintech/generate', { body, ...options });
+  }
+}
+
+export interface KfintechGenerateCasResponse {
+  msg?: string;
+
+  status?: string;
+}
+
+export interface KfintechGenerateCasParams {
+  /**
+   * Email address to receive the CAS document
+   */
+  email: string;
+
+  /**
+   * Start date (YYYY-MM-DD)
+   */
+  from_date: string;
+
+  /**
+   * Password for the PDF
+   */
+  password: string;
+
+  /**
+   * End date (YYYY-MM-DD)
+   */
+  to_date: string;
+
+  /**
+   * PAN number (optional)
+   */
+  pan_no?: string;
+}
+
+export declare namespace Kfintech {
+  export {
+    type KfintechGenerateCasResponse as KfintechGenerateCasResponse,
+    type KfintechGenerateCasParams as KfintechGenerateCasParams,
+  };
+}

package/src/resources/logs.ts

@@ -0,0 +1,170 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class Logs extends APIResource {
+  /**
+   * Retrieve detailed API usage logs for your account.
+   *
+   * Returns a list of API calls with timestamps, features used, status codes, and
+   * credits consumed. Useful for monitoring usage patterns and debugging.
+   *
+   * @example
+   * ```ts
+   * const log = await client.logs.create();
+   * ```
+   */
+  create(
+    body: LogCreateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<LogCreateResponse> {
+    return this._client.post('/logs', { body, ...options });
+  }
+
+  /**
+   * Get aggregated usage statistics grouped by feature.
+   *
+   * Useful for understanding which API features are being used most and tracking
+   * usage trends.
+   *
+   * @example
+   * ```ts
+   * const response = await client.logs.getSummary();
+   * ```
+   */
+  getSummary(
+    body: LogGetSummaryParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<LogGetSummaryResponse> {
+    return this._client.post('/logs/summary', { body, ...options });
+  }
+}
+
+export interface LogCreateResponse {
+  /**
+   * Number of logs returned
+   */
+  count?: number;
+
+  logs?: Array<LogCreateResponse.Log>;
+
+  status?: string;
+}
+
+export namespace LogCreateResponse {
+  export interface Log {
+    /**
+     * Credits consumed for this request
+     */
+    credits?: number;
+
+    /**
+     * API feature used
+     */
+    feature?: string;
+
+    /**
+     * API endpoint path
+     */
+    path?: string;
+
+    /**
+     * Unique request identifier
+     */
+    request_id?: string;
+
+    /**
+     * HTTP response status code
+     */
+    status_code?: number;
+
+    /**
+     * When the request was made
+     */
+    timestamp?: string;
+  }
+}
+
+export interface LogGetSummaryResponse {
+  status?: string;
+
+  summary?: LogGetSummaryResponse.Summary;
+}
+
+export namespace LogGetSummaryResponse {
+  export interface Summary {
+    /**
+     * Usage breakdown by feature
+     */
+    by_feature?: Array<Summary.ByFeature>;
+
+    /**
+     * Total credits consumed in the period
+     */
+    total_credits?: number;
+
+    /**
+     * Total API requests made in the period
+     */
+    total_requests?: number;
+  }
+
+  export namespace Summary {
+    export interface ByFeature {
+      /**
+       * Credits consumed by this feature
+       */
+      credits?: number;
+
+      /**
+       * API feature name
+       */
+      feature?: string;
+
+      /**
+       * Number of requests for this feature
+       */
+      requests?: number;
+    }
+  }
+}
+
+export interface LogCreateParams {
+  /**
+   * End time filter (ISO 8601). Defaults to now.
+   */
+  end_time?: string;
+
+  /**
+   * Maximum number of logs to return
+   */
+  limit?: number;
+
+  /**
+   * Start time filter (ISO 8601). Defaults to 30 days ago.
+   */
+  start_time?: string;
+}
+
+export interface LogGetSummaryParams {
+  /**
+   * End time filter (ISO 8601). Defaults to now.
+   */
+  end_time?: string;
+
+  /**
+   * Start time filter (ISO 8601). Defaults to start of current month.
+   */
+  start_time?: string;
+}
+
+export declare namespace Logs {
+  export {
+    type LogCreateResponse as LogCreateResponse,
+    type LogGetSummaryResponse as LogGetSummaryResponse,
+    type LogCreateParams as LogCreateParams,
+    type LogGetSummaryParams as LogGetSummaryParams,
+  };
+}

package/src/resources/nsdl.ts

@@ -0,0 +1,42 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as CamsKfintechAPI from './cams-kfintech';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+import { maybeMultipartFormRequestOptions } from '../internal/uploads';
+
+export class Nsdl extends APIResource {
+  /**
+   * This endpoint specifically parses NSDL CAS (Consolidated Account Statement) PDF
+   * files and returns data in a unified format. Use this endpoint when you know the
+   * PDF is from NSDL.
+   */
+  parse(body: NsdlParseParams, options?: RequestOptions): APIPromise<CamsKfintechAPI.UnifiedResponse> {
+    return this._client.post(
+      '/v4/nsdl/parse',
+      maybeMultipartFormRequestOptions({ body, ...options }, this._client),
+    );
+  }
+}
+
+export interface NsdlParseParams {
+  /**
+   * Password for the PDF file (if required)
+   */
+  password?: string;
+
+  /**
+   * Base64 encoded CAS PDF file (required if pdf_url not provided)
+   */
+  pdf_file?: string;
+
+  /**
+   * URL to the CAS PDF file (required if pdf_file not provided)
+   */
+  pdf_url?: string;
+}
+
+export declare namespace Nsdl {
+  export { type NsdlParseParams as NsdlParseParams };
+}

package/src/resources/smart.ts

@@ -0,0 +1,46 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as CamsKfintechAPI from './cams-kfintech';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+import { maybeMultipartFormRequestOptions } from '../internal/uploads';
+
+export class Smart extends APIResource {
+  /**
+   * This endpoint parses CAS (Consolidated Account Statement) PDF files from NSDL,
+   * CDSL, or CAMS/KFintech and returns data in a unified format. It auto-detects the
+   * CAS type and transforms the data into a consistent structure regardless of the
+   * source.
+   */
+  parseCasPdf(
+    body: SmartParseCasPdfParams,
+    options?: RequestOptions,
+  ): APIPromise<CamsKfintechAPI.UnifiedResponse> {
+    return this._client.post(
+      '/v4/smart/parse',
+      maybeMultipartFormRequestOptions({ body, ...options }, this._client),
+    );
+  }
+}
+
+export interface SmartParseCasPdfParams {
+  /**
+   * Password for the PDF file (if required)
+   */
+  password?: string;
+
+  /**
+   * Base64 encoded CAS PDF file (required if pdf_url not provided)
+   */
+  pdf_file?: string;
+
+  /**
+   * URL to the CAS PDF file (required if pdf_file not provided)
+   */
+  pdf_url?: string;
+}
+
+export declare namespace Smart {
+  export { type SmartParseCasPdfParams as SmartParseCasPdfParams };
+}

package/src/resources/verify-token.ts

@@ -0,0 +1,36 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+
+export class VerifyToken extends APIResource {
+  /**
+   * Verify an access token and check if it's still valid. Useful for debugging token
+   * issues.
+   */
+  verify(options?: RequestOptions): APIPromise<VerifyTokenVerifyResponse> {
+    return this._client.post('/v1/verify-token', options);
+  }
+}
+
+export interface VerifyTokenVerifyResponse {
+  /**
+   * Error message (only shown if invalid)
+   */
+  error?: string;
+
+  /**
+   * Masked API key (only shown if valid)
+   */
+  masked_api_key?: string;
+
+  /**
+   * Whether the token is valid
+   */
+  valid?: boolean;
+}
+
+export declare namespace VerifyToken {
+  export { type VerifyTokenVerifyResponse as VerifyTokenVerifyResponse };
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.4.1'; // x-release-please-version
+export const VERSION = '1.6.2'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.4.1";
+export declare const VERSION = "1.6.2";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.4.1";
+export declare const VERSION = "1.6.2";
 //# sourceMappingURL=version.d.ts.map