@linkt/sdk 0.2.0

package/resources/files.d.ts

@@ -0,0 +1,170 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { type Uploadable } from "../core/uploads.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Files extends APIResource {
+    /**
+     * Get file details by ID.
+     *
+     * Returns metadata for a specific file including name, size, and processing
+     * status. Use this to check if a file is ready for use in workflows.
+     */
+    retrieve(fileID: string, options?: RequestOptions): APIPromise<FileRetrieveResponse>;
+    /**
+     * List uploaded files.
+     *
+     * Returns a paginated list of all files uploaded by your organization. Files can
+     * be used as data sources for signal monitoring and ingest tasks.
+     */
+    list(query?: FileListParams | null | undefined, options?: RequestOptions): APIPromise<FileListResponse>;
+    /**
+     * Upload a CSV or XLSX file.
+     *
+     * Upload a data file for use in signal monitoring or ingest workflows. The file is
+     * stored securely and can be referenced when creating tasks. XLSX files are
+     * automatically converted to CSV format (first sheet only).
+     */
+    upload(body: FileUploadParams, options?: RequestOptions): APIPromise<FileUploadResponse>;
+}
+/**
+ * Processing status for CSV files.
+ */
+export type CsvProcessingStatus = 'pending' | 'processing' | 'completed' | 'failed';
+/**
+ * Response model for file details.
+ */
+export interface FileRetrieveResponse {
+    /**
+     * Content type of the file
+     */
+    content_type: string;
+    /**
+     * The ID of the file
+     */
+    file_id: string;
+    /**
+     * The name of the file
+     */
+    name: string;
+    /**
+     * S3 URI of the file
+     */
+    s3_uri: string;
+    /**
+     * Size of the file in bytes
+     */
+    size_bytes: number;
+    /**
+     * CSV metadata
+     */
+    csv_metadata?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Original file type if converted (e.g., 'xlsx' if XLSX was converted to CSV)
+     */
+    original_file_type?: string | null;
+    /**
+     * Processing status
+     */
+    processing_status?: CsvProcessingStatus;
+}
+/**
+ * Response model for file listing.
+ */
+export interface FileListResponse {
+    /**
+     * List of files
+     */
+    files: Array<FileListResponse.File>;
+    /**
+     * Current page number
+     */
+    page: number;
+    /**
+     * Number of items per page
+     */
+    page_size: number;
+    /**
+     * Total number of files
+     */
+    total: number;
+}
+export declare namespace FileListResponse {
+    /**
+     * File item in list response.
+     */
+    interface File {
+        /**
+         * The ID of the file
+         */
+        file_id: string;
+        /**
+         * The name of the file
+         */
+        name: string;
+        /**
+         * Size of the file in bytes
+         */
+        size_bytes: number;
+    }
+}
+/**
+ * Response model for file upload.
+ */
+export interface FileUploadResponse {
+    /**
+     * Content type of the file
+     */
+    content_type: string;
+    /**
+     * The ID of the uploaded file
+     */
+    file_id: string;
+    /**
+     * The name of the file
+     */
+    name: string;
+    /**
+     * Processing status
+     */
+    processing_status: CsvProcessingStatus;
+    /**
+     * S3 URI of the uploaded file
+     */
+    s3_uri: string;
+    /**
+     * Size of the file in bytes
+     */
+    size_bytes: number;
+    /**
+     * CSV metadata
+     */
+    csv_metadata?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Original file type if converted (e.g., 'xlsx' if XLSX was converted to CSV)
+     */
+    original_file_type?: string | null;
+}
+export interface FileListParams {
+    /**
+     * Page number (1-based)
+     */
+    page?: number;
+    /**
+     * Items per page
+     */
+    page_size?: number;
+}
+export interface FileUploadParams {
+    /**
+     * CSV or XLSX file to upload
+     */
+    file: Uploadable;
+}
+export declare namespace Files {
+    export { type CsvProcessingStatus as CsvProcessingStatus, type FileRetrieveResponse as FileRetrieveResponse, type FileListResponse as FileListResponse, type FileUploadResponse as FileUploadResponse, type FileListParams as FileListParams, type FileUploadParams as FileUploadParams, };
+}
+//# sourceMappingURL=files.d.ts.map

package/resources/files.d.ts.map

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

package/resources/files.js

@@ -0,0 +1,39 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Files = void 0;
+const resource_1 = require("../core/resource.js");
+const uploads_1 = require("../internal/uploads.js");
+const path_1 = require("../internal/utils/path.js");
+class Files extends resource_1.APIResource {
+    /**
+     * Get file details by ID.
+     *
+     * Returns metadata for a specific file including name, size, and processing
+     * status. Use this to check if a file is ready for use in workflows.
+     */
+    retrieve(fileID, options) {
+        return this._client.get((0, path_1.path) `/v1/files/${fileID}`, options);
+    }
+    /**
+     * List uploaded files.
+     *
+     * Returns a paginated list of all files uploaded by your organization. Files can
+     * be used as data sources for signal monitoring and ingest tasks.
+     */
+    list(query = {}, options) {
+        return this._client.get('/v1/files', { query, ...options });
+    }
+    /**
+     * Upload a CSV or XLSX file.
+     *
+     * Upload a data file for use in signal monitoring or ingest workflows. The file is
+     * stored securely and can be referenced when creating tasks. XLSX files are
+     * automatically converted to CSV format (first sheet only).
+     */
+    upload(body, options) {
+        return this._client.post('/v1/files/upload', (0, uploads_1.multipartFormRequestOptions)({ body, ...options }, this._client));
+    }
+}
+exports.Files = Files;
+//# sourceMappingURL=files.js.map

package/resources/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../src/resources/files.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,oDAAkE;AAClE,oDAA8C;AAE9C,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,kBAAkB,EAClB,IAAA,qCAA2B,EAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAChE,CAAC;IACJ,CAAC;CACF;AArCD,sBAqCC"}

package/resources/files.mjs

@@ -0,0 +1,35 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { multipartFormRequestOptions } from "../internal/uploads.mjs";
+import { path } from "../internal/utils/path.mjs";
+export class Files extends APIResource {
+    /**
+     * Get file details by ID.
+     *
+     * Returns metadata for a specific file including name, size, and processing
+     * status. Use this to check if a file is ready for use in workflows.
+     */
+    retrieve(fileID, options) {
+        return this._client.get(path `/v1/files/${fileID}`, options);
+    }
+    /**
+     * List uploaded files.
+     *
+     * Returns a paginated list of all files uploaded by your organization. Files can
+     * be used as data sources for signal monitoring and ingest tasks.
+     */
+    list(query = {}, options) {
+        return this._client.get('/v1/files', { query, ...options });
+    }
+    /**
+     * Upload a CSV or XLSX file.
+     *
+     * Upload a data file for use in signal monitoring or ingest workflows. The file is
+     * stored securely and can be referenced when creating tasks. XLSX files are
+     * automatically converted to CSV format (first sheet only).
+     */
+    upload(body, options) {
+        return this._client.post('/v1/files/upload', multipartFormRequestOptions({ body, ...options }, this._client));
+    }
+}
+//# sourceMappingURL=files.mjs.map

package/resources/files.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.mjs","sourceRoot":"","sources":["../src/resources/files.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAIf,EAAE,2BAA2B,EAAE;OAC/B,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,IAAsB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,kBAAkB,EAClB,2BAA2B,CAAC,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAChE,CAAC;IACJ,CAAC;CACF"}

package/resources/icp.d.mts

@@ -0,0 +1,162 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class Icp extends APIResource {
+    /**
+     * Create a new Ideal Customer Profile (ICP).
+     *
+     * ICPs are the foundation of your research workflows. They define WHAT entities to
+     * target using business-level descriptions and filters, without specifying
+     * technical implementation details.
+     *
+     * Create an ICP first, then link Sheets to it for entity storage.
+     */
+    create(body: IcpCreateParams, options?: RequestOptions): APIPromise<IcpResponse>;
+    /**
+     * Get a specific ICP by ID.
+     */
+    retrieve(icpID: string, options?: RequestOptions): APIPromise<IcpResponse>;
+    /**
+     * Update an existing ICP.
+     *
+     * Only provided fields will be updated; omitted fields remain unchanged.
+     */
+    update(icpID: string, body: IcpUpdateParams, options?: RequestOptions): APIPromise<IcpResponse>;
+    /**
+     * List all ICPs for the organization.
+     *
+     * Results are scoped to your organization. Use the `mode` filter to separate
+     * discovery ICPs (for finding new entities) from monitoring ICPs (for tracking
+     * existing entities).
+     */
+    list(query?: IcpListParams | null | undefined, options?: RequestOptions): APIPromise<IcpListResponse>;
+    /**
+     * Delete an ICP and all related resources.
+     *
+     * **Cascade delete**: This permanently removes the ICP along with all associated
+     * sheets, entities, schedules, tasks, and signals. This operation cannot be
+     * undone.
+     */
+    delete(icpID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Get all active runs for an ICP.
+     *
+     * Returns runs in non-terminal states (RUNNING, SCHEDULED, PENDING). Useful for
+     * checking if workflows are currently processing this ICP before making changes.
+     */
+    getActiveRuns(icpID: string, options?: RequestOptions): APIPromise<IcpGetActiveRunsResponse>;
+}
+/**
+ * Request model for entity target configuration.
+ */
+export interface EntityTargetConfig {
+    /**
+     * Business description of targets
+     */
+    description: string;
+    /**
+     * Entity type to target
+     */
+    entity_type: string;
+    /**
+     * Filters to apply
+     */
+    filters?: Array<string>;
+}
+/**
+ * Response model for ICP.
+ */
+export interface IcpResponse {
+    id: string;
+    created_at: string;
+    description: string;
+    entity_targets: Array<IcpResponse.EntityTarget>;
+    name: string;
+    updated_at: string;
+}
+export declare namespace IcpResponse {
+    /**
+     * Response model for entity target configuration.
+     */
+    interface EntityTarget {
+        description: string;
+        entity_type: string;
+        root: boolean;
+    }
+}
+/**
+ * Response for listing ICPs.
+ */
+export interface IcpListResponse {
+    icps: Array<IcpResponse>;
+    page: number;
+    page_size: number;
+    total: number;
+}
+/**
+ * Response model for ICP running status.
+ */
+export interface IcpGetActiveRunsResponse {
+    runs: Array<IcpGetActiveRunsResponse.Run>;
+}
+export declare namespace IcpGetActiveRunsResponse {
+    /**
+     * Individual run status item for API responses.
+     *
+     * Includes both agent_type (execution context) and task_type (workflow type)
+     * fields to support filtering and display during the transition from legacy runs.
+     *
+     * Attributes: id: Unique run identifier (ObjectId as string) agent_type: HOW the
+     * run was triggered ("task", "play") task_type: WHAT workflow runs ("signal",
+     * "search", "profile", "ingest"). None for plays or legacy runs without this
+     * field. created_at: When the run was created
+     */
+    interface Run {
+        /**
+         * Run ID
+         */
+        id: string;
+        /**
+         * Execution context (task, play)
+         */
+        agent_type: string;
+        /**
+         * Creation timestamp
+         */
+        created_at?: string | null;
+        /**
+         * Workflow type for task-based runs (signal, search, profile, ingest)
+         */
+        task_type?: string | null;
+    }
+}
+export interface IcpCreateParams {
+    description: string;
+    entity_targets: Array<EntityTargetConfig>;
+    name: string;
+}
+export interface IcpUpdateParams {
+    description?: string | null;
+    entity_targets?: Array<EntityTargetConfig> | null;
+    name?: string | null;
+}
+export interface IcpListParams {
+    /**
+     * Filter by ICP mode: 'discovery' or 'monitoring'
+     */
+    mode?: 'discovery' | 'monitoring' | null;
+    /**
+     * Sort order: -1 for descending, 1 for ascending
+     */
+    order?: number | null;
+    page?: number;
+    page_size?: number;
+    /**
+     * Field to sort by (e.g., 'created_at', 'updated_at', 'name')
+     */
+    sort_by?: string | null;
+}
+export declare namespace Icp {
+    export { type EntityTargetConfig as EntityTargetConfig, type IcpResponse as IcpResponse, type IcpListResponse as IcpListResponse, type IcpGetActiveRunsResponse as IcpGetActiveRunsResponse, type IcpCreateParams as IcpCreateParams, type IcpUpdateParams as IcpUpdateParams, type IcpListParams as IcpListParams, };
+}
+//# sourceMappingURL=icp.d.mts.map

package/resources/icp.d.mts.map

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

package/resources/icp.d.ts

@@ -0,0 +1,162 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Icp extends APIResource {
+    /**
+     * Create a new Ideal Customer Profile (ICP).
+     *
+     * ICPs are the foundation of your research workflows. They define WHAT entities to
+     * target using business-level descriptions and filters, without specifying
+     * technical implementation details.
+     *
+     * Create an ICP first, then link Sheets to it for entity storage.
+     */
+    create(body: IcpCreateParams, options?: RequestOptions): APIPromise<IcpResponse>;
+    /**
+     * Get a specific ICP by ID.
+     */
+    retrieve(icpID: string, options?: RequestOptions): APIPromise<IcpResponse>;
+    /**
+     * Update an existing ICP.
+     *
+     * Only provided fields will be updated; omitted fields remain unchanged.
+     */
+    update(icpID: string, body: IcpUpdateParams, options?: RequestOptions): APIPromise<IcpResponse>;
+    /**
+     * List all ICPs for the organization.
+     *
+     * Results are scoped to your organization. Use the `mode` filter to separate
+     * discovery ICPs (for finding new entities) from monitoring ICPs (for tracking
+     * existing entities).
+     */
+    list(query?: IcpListParams | null | undefined, options?: RequestOptions): APIPromise<IcpListResponse>;
+    /**
+     * Delete an ICP and all related resources.
+     *
+     * **Cascade delete**: This permanently removes the ICP along with all associated
+     * sheets, entities, schedules, tasks, and signals. This operation cannot be
+     * undone.
+     */
+    delete(icpID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Get all active runs for an ICP.
+     *
+     * Returns runs in non-terminal states (RUNNING, SCHEDULED, PENDING). Useful for
+     * checking if workflows are currently processing this ICP before making changes.
+     */
+    getActiveRuns(icpID: string, options?: RequestOptions): APIPromise<IcpGetActiveRunsResponse>;
+}
+/**
+ * Request model for entity target configuration.
+ */
+export interface EntityTargetConfig {
+    /**
+     * Business description of targets
+     */
+    description: string;
+    /**
+     * Entity type to target
+     */
+    entity_type: string;
+    /**
+     * Filters to apply
+     */
+    filters?: Array<string>;
+}
+/**
+ * Response model for ICP.
+ */
+export interface IcpResponse {
+    id: string;
+    created_at: string;
+    description: string;
+    entity_targets: Array<IcpResponse.EntityTarget>;
+    name: string;
+    updated_at: string;
+}
+export declare namespace IcpResponse {
+    /**
+     * Response model for entity target configuration.
+     */
+    interface EntityTarget {
+        description: string;
+        entity_type: string;
+        root: boolean;
+    }
+}
+/**
+ * Response for listing ICPs.
+ */
+export interface IcpListResponse {
+    icps: Array<IcpResponse>;
+    page: number;
+    page_size: number;
+    total: number;
+}
+/**
+ * Response model for ICP running status.
+ */
+export interface IcpGetActiveRunsResponse {
+    runs: Array<IcpGetActiveRunsResponse.Run>;
+}
+export declare namespace IcpGetActiveRunsResponse {
+    /**
+     * Individual run status item for API responses.
+     *
+     * Includes both agent_type (execution context) and task_type (workflow type)
+     * fields to support filtering and display during the transition from legacy runs.
+     *
+     * Attributes: id: Unique run identifier (ObjectId as string) agent_type: HOW the
+     * run was triggered ("task", "play") task_type: WHAT workflow runs ("signal",
+     * "search", "profile", "ingest"). None for plays or legacy runs without this
+     * field. created_at: When the run was created
+     */
+    interface Run {
+        /**
+         * Run ID
+         */
+        id: string;
+        /**
+         * Execution context (task, play)
+         */
+        agent_type: string;
+        /**
+         * Creation timestamp
+         */
+        created_at?: string | null;
+        /**
+         * Workflow type for task-based runs (signal, search, profile, ingest)
+         */
+        task_type?: string | null;
+    }
+}
+export interface IcpCreateParams {
+    description: string;
+    entity_targets: Array<EntityTargetConfig>;
+    name: string;
+}
+export interface IcpUpdateParams {
+    description?: string | null;
+    entity_targets?: Array<EntityTargetConfig> | null;
+    name?: string | null;
+}
+export interface IcpListParams {
+    /**
+     * Filter by ICP mode: 'discovery' or 'monitoring'
+     */
+    mode?: 'discovery' | 'monitoring' | null;
+    /**
+     * Sort order: -1 for descending, 1 for ascending
+     */
+    order?: number | null;
+    page?: number;
+    page_size?: number;
+    /**
+     * Field to sort by (e.g., 'created_at', 'updated_at', 'name')
+     */
+    sort_by?: string | null;
+}
+export declare namespace Icp {
+    export { type EntityTargetConfig as EntityTargetConfig, type IcpResponse as IcpResponse, type IcpListResponse as IcpListResponse, type IcpGetActiveRunsResponse as IcpGetActiveRunsResponse, type IcpCreateParams as IcpCreateParams, type IcpUpdateParams as IcpUpdateParams, type IcpListParams as IcpListParams, };
+}
+//# sourceMappingURL=icp.d.ts.map

package/resources/icp.d.ts.map

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

package/resources/icp.js

@@ -0,0 +1,69 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Icp = void 0;
+const resource_1 = require("../core/resource.js");
+const headers_1 = require("../internal/headers.js");
+const path_1 = require("../internal/utils/path.js");
+class Icp extends resource_1.APIResource {
+    /**
+     * Create a new Ideal Customer Profile (ICP).
+     *
+     * ICPs are the foundation of your research workflows. They define WHAT entities to
+     * target using business-level descriptions and filters, without specifying
+     * technical implementation details.
+     *
+     * Create an ICP first, then link Sheets to it for entity storage.
+     */
+    create(body, options) {
+        return this._client.post('/v1/icp', { body, ...options });
+    }
+    /**
+     * Get a specific ICP by ID.
+     */
+    retrieve(icpID, options) {
+        return this._client.get((0, path_1.path) `/v1/icp/${icpID}`, options);
+    }
+    /**
+     * Update an existing ICP.
+     *
+     * Only provided fields will be updated; omitted fields remain unchanged.
+     */
+    update(icpID, body, options) {
+        return this._client.put((0, path_1.path) `/v1/icp/${icpID}`, { body, ...options });
+    }
+    /**
+     * List all ICPs for the organization.
+     *
+     * Results are scoped to your organization. Use the `mode` filter to separate
+     * discovery ICPs (for finding new entities) from monitoring ICPs (for tracking
+     * existing entities).
+     */
+    list(query = {}, options) {
+        return this._client.get('/v1/icp', { query, ...options });
+    }
+    /**
+     * Delete an ICP and all related resources.
+     *
+     * **Cascade delete**: This permanently removes the ICP along with all associated
+     * sheets, entities, schedules, tasks, and signals. This operation cannot be
+     * undone.
+     */
+    delete(icpID, options) {
+        return this._client.delete((0, path_1.path) `/v1/icp/${icpID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Get all active runs for an ICP.
+     *
+     * Returns runs in non-terminal states (RUNNING, SCHEDULED, PENDING). Useful for
+     * checking if workflows are currently processing this ICP before making changes.
+     */
+    getActiveRuns(icpID, options) {
+        return this._client.get((0, path_1.path) `/v1/icp/${icpID}/active_runs`, options);
+    }
+}
+exports.Icp = Icp;
+//# sourceMappingURL=icp.js.map

package/resources/icp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icp.js","sourceRoot":"","sources":["../src/resources/icp.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,oDAAmD;AAEnD,oDAA8C;AAE9C,MAAa,GAAI,SAAQ,sBAAW;IAClC;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,WAAW,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAa,EAAE,IAAqB,EAAE,OAAwB;QACnE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,WAAW,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,QAA0C,EAAE,EAAE,OAAwB;QACzE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,KAAa,EAAE,OAAwB;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,WAAW,KAAK,EAAE,EAAE;YACjD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,KAAa,EAAE,OAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,WAAW,KAAK,cAAc,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;CACF;AAhED,kBAgEC"}