@datalayer/core 0.0.20 → 0.0.23

package/lib/api/iam/datasources.d.ts

@@ -0,0 +1,86 @@
+import type { CreateDatasourceRequest, CreateDatasourceResponse, GetDatasourceResponse, ListDatasourcesResponse, UpdateDatasourceRequest, UpdateDatasourceResponse } from '../../models/Datasource';
+/**
+ * Create a new datasource.
+ * Creates a new datasource configuration for the authenticated user.
+ *
+ * @param token - Authentication token
+ * @param data - Datasource creation data
+ * @param baseUrl - Base URL for IAM service
+ * @returns Created datasource data
+ *
+ * @example
+ * ```typescript
+ * const response = await createDatasource(token, {
+ *   type: 'Amazon Athena',
+ *   name: 'my-athena-datasource',
+ *   description: 'Production Athena datasource',
+ *   database: 'my_database',
+ *   output_bucket: 's3://my-bucket/output/'
+ * });
+ * ```
+ */
+export declare const createDatasource: (token: string, data: CreateDatasourceRequest, baseUrl?: string) => Promise<CreateDatasourceResponse>;
+/**
+ * List all datasources for authenticated user.
+ * Retrieves all datasource configurations accessible to the user.
+ *
+ * @param token - Authentication token
+ * @param baseUrl - Base URL for IAM service
+ * @returns List of datasources
+ *
+ * @example
+ * ```typescript
+ * const response = await listDatasources(token);
+ * console.log(response.datasources);
+ * ```
+ */
+export declare const listDatasources: (token: string, baseUrl?: string) => Promise<ListDatasourcesResponse>;
+/**
+ * Get a specific datasource by ID.
+ * Retrieves detailed information about a specific datasource.
+ *
+ * @param token - Authentication token
+ * @param datasourceId - Datasource unique identifier
+ * @param baseUrl - Base URL for IAM service
+ * @returns Datasource data
+ *
+ * @example
+ * ```typescript
+ * const response = await getDatasource(token, 'datasource-id-123');
+ * console.log(response.datasource);
+ * ```
+ */
+export declare const getDatasource: (token: string, datasourceId: string, baseUrl?: string) => Promise<GetDatasourceResponse>;
+/**
+ * Update a specific datasource.
+ * Updates the configuration of an existing datasource.
+ *
+ * @param token - Authentication token
+ * @param datasourceId - Datasource unique identifier
+ * @param data - Update data
+ * @param baseUrl - Base URL for IAM service
+ * @returns Updated datasource data
+ *
+ * @example
+ * ```typescript
+ * const response = await updateDatasource(token, 'datasource-id-123', {
+ *   description: 'Updated description',
+ *   database: 'new_database'
+ * });
+ * ```
+ */
+export declare const updateDatasource: (token: string, datasourceId: string, data: UpdateDatasourceRequest, baseUrl?: string) => Promise<UpdateDatasourceResponse>;
+/**
+ * Delete a specific datasource.
+ * Removes a datasource configuration.
+ *
+ * @param token - Authentication token
+ * @param datasourceId - Datasource unique identifier
+ * @param baseUrl - Base URL for IAM service
+ *
+ * @example
+ * ```typescript
+ * await deleteDatasource(token, 'datasource-id-123');
+ * ```
+ */
+export declare const deleteDatasource: (token: string, datasourceId: string, baseUrl?: string) => Promise<void>;

package/lib/api/iam/datasources.js

@@ -0,0 +1,185 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Datasources API functions.
+ * @module api/iam/datasources
+ */
+import { requestDatalayerAPI } from '../DatalayerApi';
+import { API_BASE_PATHS, DEFAULT_SERVICE_URLS } from '../constants';
+import { validateToken, validateRequiredString } from '../utils/validation';
+/**
+ * Create a new datasource.
+ * Creates a new datasource configuration for the authenticated user.
+ *
+ * @param token - Authentication token
+ * @param data - Datasource creation data
+ * @param baseUrl - Base URL for IAM service
+ * @returns Created datasource data
+ *
+ * @example
+ * ```typescript
+ * const response = await createDatasource(token, {
+ *   type: 'Amazon Athena',
+ *   name: 'my-athena-datasource',
+ *   description: 'Production Athena datasource',
+ *   database: 'my_database',
+ *   output_bucket: 's3://my-bucket/output/'
+ * });
+ * ```
+ */
+export const createDatasource = async (token, data, baseUrl = DEFAULT_SERVICE_URLS.IAM) => {
+    validateToken(token);
+    validateRequiredString(data.name, 'Datasource name');
+    validateRequiredString(data.type, 'Datasource type');
+    // Map datasource type to API variant format
+    const variantMap = {
+        'Amazon Athena': 'athena',
+        'Google BigQuery': 'bigquery',
+        'Microsoft Sentinel': 'sentinel',
+        Splunk: 'splunk',
+    };
+    const requestBody = {
+        name: data.name,
+        variant: variantMap[data.type] || data.type.toLowerCase(),
+        description: data.description || '',
+        database: data.database || '',
+        outputBucket: data.output_bucket || '',
+    };
+    try {
+        return await requestDatalayerAPI({
+            url: `${baseUrl}${API_BASE_PATHS.IAM}/datasources`,
+            method: 'POST',
+            body: requestBody,
+            token,
+        });
+    }
+    catch (error) {
+        if (error.response?.status === 409) {
+            throw new Error(`Datasource with name '${data.name}' already exists. Please use a different name.`);
+        }
+        throw error;
+    }
+};
+/**
+ * List all datasources for authenticated user.
+ * Retrieves all datasource configurations accessible to the user.
+ *
+ * @param token - Authentication token
+ * @param baseUrl - Base URL for IAM service
+ * @returns List of datasources
+ *
+ * @example
+ * ```typescript
+ * const response = await listDatasources(token);
+ * console.log(response.datasources);
+ * ```
+ */
+export const listDatasources = async (token, baseUrl = DEFAULT_SERVICE_URLS.IAM) => {
+    validateToken(token);
+    return await requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.IAM}/datasources`,
+        method: 'GET',
+        token,
+    });
+};
+/**
+ * Get a specific datasource by ID.
+ * Retrieves detailed information about a specific datasource.
+ *
+ * @param token - Authentication token
+ * @param datasourceId - Datasource unique identifier
+ * @param baseUrl - Base URL for IAM service
+ * @returns Datasource data
+ *
+ * @example
+ * ```typescript
+ * const response = await getDatasource(token, 'datasource-id-123');
+ * console.log(response.datasource);
+ * ```
+ */
+export const getDatasource = async (token, datasourceId, baseUrl = DEFAULT_SERVICE_URLS.IAM) => {
+    validateToken(token);
+    validateRequiredString(datasourceId, 'Datasource ID');
+    try {
+        return await requestDatalayerAPI({
+            url: `${baseUrl}${API_BASE_PATHS.IAM}/datasources/${datasourceId}`,
+            method: 'GET',
+            token,
+        });
+    }
+    catch (error) {
+        if (error.response?.status === 404) {
+            throw new Error(`Datasource '${datasourceId}' not found.`);
+        }
+        throw error;
+    }
+};
+/**
+ * Update a specific datasource.
+ * Updates the configuration of an existing datasource.
+ *
+ * @param token - Authentication token
+ * @param datasourceId - Datasource unique identifier
+ * @param data - Update data
+ * @param baseUrl - Base URL for IAM service
+ * @returns Updated datasource data
+ *
+ * @example
+ * ```typescript
+ * const response = await updateDatasource(token, 'datasource-id-123', {
+ *   description: 'Updated description',
+ *   database: 'new_database'
+ * });
+ * ```
+ */
+export const updateDatasource = async (token, datasourceId, data, baseUrl = DEFAULT_SERVICE_URLS.IAM) => {
+    validateToken(token);
+    validateRequiredString(datasourceId, 'Datasource ID');
+    const requestBody = { ...data };
+    try {
+        return await requestDatalayerAPI({
+            url: `${baseUrl}${API_BASE_PATHS.IAM}/datasources/${datasourceId}`,
+            method: 'PUT',
+            body: requestBody,
+            token,
+        });
+    }
+    catch (error) {
+        if (error.response?.status === 404) {
+            throw new Error(`Datasource '${datasourceId}' not found.`);
+        }
+        throw error;
+    }
+};
+/**
+ * Delete a specific datasource.
+ * Removes a datasource configuration.
+ *
+ * @param token - Authentication token
+ * @param datasourceId - Datasource unique identifier
+ * @param baseUrl - Base URL for IAM service
+ *
+ * @example
+ * ```typescript
+ * await deleteDatasource(token, 'datasource-id-123');
+ * ```
+ */
+export const deleteDatasource = async (token, datasourceId, baseUrl = DEFAULT_SERVICE_URLS.IAM) => {
+    validateToken(token);
+    validateRequiredString(datasourceId, 'Datasource ID');
+    try {
+        await requestDatalayerAPI({
+            url: `${baseUrl}${API_BASE_PATHS.IAM}/datasources/${datasourceId}`,
+            method: 'DELETE',
+            token,
+        });
+    }
+    catch (error) {
+        if (error.response?.status === 404) {
+            throw new Error(`Datasource '${datasourceId}' not found.`);
+        }
+        throw error;
+    }
+};

package/lib/api/iam/index.d.ts

@@ -10,6 +10,8 @@ export * as oauth2 from './oauth2';
 export * as profile from './profile';
 export * as healthz from './healthz';
 export * as usage from './usage';
+export * as secrets from './secrets';
+export * as datasources from './datasources';
 export { login, logout, checkAuth } from './authentication';
 export { getOAuth2AuthzUrl, getOAuth2AuthzUrlForLink, handleGitHubOAuth2Callback, handleLinkedInOAuth2Callback, handleOktaOAuth2Callback, type OAuth2Provider, type OAuth2AuthzUrlResponse, type OAuth2CallbackParams, type OAuth2CallbackResponse, } from './oauth2';
 export { me, whoami } from './profile';

package/lib/api/iam/index.js

@@ -14,6 +14,8 @@ export * as oauth2 from './oauth2';
 export * as profile from './profile';
 export * as healthz from './healthz';
 export * as usage from './usage';
+export * as secrets from './secrets';
+export * as datasources from './datasources';
 // For backward compatibility, export the old API structure
 export { login, logout, checkAuth } from './authentication';
 export { getOAuth2AuthzUrl, getOAuth2AuthzUrlForLink, handleGitHubOAuth2Callback, handleLinkedInOAuth2Callback, handleOktaOAuth2Callback, } from './oauth2';

package/lib/api/iam/secrets.d.ts

@@ -0,0 +1,85 @@
+import type { CreateSecretRequest, CreateSecretResponse, GetSecretResponse, ListSecretsResponse, UpdateSecretRequest, UpdateSecretResponse } from '../../models/Secret';
+/**
+ * Create a new secret.
+ * Creates a new encrypted secret for the authenticated user.
+ *
+ * @param token - Authentication token
+ * @param data - Secret creation data
+ * @param baseUrl - Base URL for IAM service
+ * @returns Created secret data
+ *
+ * @example
+ * ```typescript
+ * const response = await createSecret(token, {
+ *   variant: 'password',
+ *   name: 'db_password',
+ *   description: 'Production database password',
+ *   value: 'my-secure-password'
+ * });
+ * ```
+ */
+export declare const createSecret: (token: string, data: CreateSecretRequest, baseUrl?: string) => Promise<CreateSecretResponse>;
+/**
+ * List all secrets for authenticated user.
+ * Retrieves all secret configurations accessible to the user.
+ *
+ * @param token - Authentication token
+ * @param baseUrl - Base URL for IAM service
+ * @returns List of secrets
+ *
+ * @example
+ * ```typescript
+ * const response = await listSecrets(token);
+ * console.log(response.secrets);
+ * ```
+ */
+export declare const listSecrets: (token: string, baseUrl?: string) => Promise<ListSecretsResponse>;
+/**
+ * Get a specific secret by ID.
+ * Retrieves detailed information about a specific secret.
+ *
+ * @param token - Authentication token
+ * @param secretId - Secret unique identifier
+ * @param baseUrl - Base URL for IAM service
+ * @returns Secret data
+ *
+ * @example
+ * ```typescript
+ * const response = await getSecret(token, 'secret-id-123');
+ * console.log(response.secret);
+ * ```
+ */
+export declare const getSecret: (token: string, secretId: string, baseUrl?: string) => Promise<GetSecretResponse>;
+/**
+ * Update a specific secret.
+ * Updates the configuration of an existing secret.
+ *
+ * @param token - Authentication token
+ * @param secretId - Secret unique identifier
+ * @param data - Update data
+ * @param baseUrl - Base URL for IAM service
+ * @returns Updated secret data
+ *
+ * @example
+ * ```typescript
+ * const response = await updateSecret(token, 'secret-id-123', {
+ *   description: 'Updated description',
+ *   value: 'new-password'
+ * });
+ * ```
+ */
+export declare const updateSecret: (token: string, secretId: string, data: UpdateSecretRequest, baseUrl?: string) => Promise<UpdateSecretResponse>;
+/**
+ * Delete a specific secret.
+ * Removes a secret configuration and its encrypted data.
+ *
+ * @param token - Authentication token
+ * @param secretId - Secret unique identifier
+ * @param baseUrl - Base URL for IAM service
+ *
+ * @example
+ * ```typescript
+ * await deleteSecret(token, 'secret-id-123');
+ * ```
+ */
+export declare const deleteSecret: (token: string, secretId: string, baseUrl?: string) => Promise<void>;

package/lib/api/iam/secrets.js

@@ -0,0 +1,196 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Secrets API functions.
+ * @module api/secrets/secrets
+ */
+import { requestDatalayerAPI } from '../DatalayerApi';
+import { API_BASE_PATHS, DEFAULT_SERVICE_URLS } from '../constants';
+import { validateToken, validateRequiredString } from '../utils/validation';
+/**
+ * Helper function to Base64 encode a value (cross-platform).
+ * @param value - Plain text value to encode
+ * @returns Base64 encoded string
+ */
+function encodeValue(value) {
+    if (typeof Buffer !== 'undefined') {
+        // Node.js environment
+        return Buffer.from(value).toString('base64');
+    }
+    else {
+        // Browser environment
+        return btoa(value);
+    }
+}
+/**
+ * Create a new secret.
+ * Creates a new encrypted secret for the authenticated user.
+ *
+ * @param token - Authentication token
+ * @param data - Secret creation data
+ * @param baseUrl - Base URL for IAM service
+ * @returns Created secret data
+ *
+ * @example
+ * ```typescript
+ * const response = await createSecret(token, {
+ *   variant: 'password',
+ *   name: 'db_password',
+ *   description: 'Production database password',
+ *   value: 'my-secure-password'
+ * });
+ * ```
+ */
+export const createSecret = async (token, data, baseUrl = DEFAULT_SERVICE_URLS.IAM) => {
+    validateToken(token);
+    validateRequiredString(data.name, 'Secret name');
+    validateRequiredString(data.value, 'Secret value');
+    // Base64 encode the value before sending to API
+    const requestBody = {
+        variant: data.variant || 'generic',
+        name: data.name,
+        description: data.description || '',
+        value: encodeValue(data.value),
+    };
+    try {
+        return await requestDatalayerAPI({
+            url: `${baseUrl}${API_BASE_PATHS.IAM}/secrets`,
+            method: 'POST',
+            body: requestBody,
+            token,
+        });
+    }
+    catch (error) {
+        if (error.response?.status === 409) {
+            throw new Error(`Secret with name '${data.name}' already exists. Please use a different name.`);
+        }
+        throw error;
+    }
+};
+/**
+ * List all secrets for authenticated user.
+ * Retrieves all secret configurations accessible to the user.
+ *
+ * @param token - Authentication token
+ * @param baseUrl - Base URL for IAM service
+ * @returns List of secrets
+ *
+ * @example
+ * ```typescript
+ * const response = await listSecrets(token);
+ * console.log(response.secrets);
+ * ```
+ */
+export const listSecrets = async (token, baseUrl = DEFAULT_SERVICE_URLS.IAM) => {
+    validateToken(token);
+    return await requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.IAM}/secrets`,
+        method: 'GET',
+        token,
+    });
+};
+/**
+ * Get a specific secret by ID.
+ * Retrieves detailed information about a specific secret.
+ *
+ * @param token - Authentication token
+ * @param secretId - Secret unique identifier
+ * @param baseUrl - Base URL for IAM service
+ * @returns Secret data
+ *
+ * @example
+ * ```typescript
+ * const response = await getSecret(token, 'secret-id-123');
+ * console.log(response.secret);
+ * ```
+ */
+export const getSecret = async (token, secretId, baseUrl = DEFAULT_SERVICE_URLS.IAM) => {
+    validateToken(token);
+    validateRequiredString(secretId, 'Secret ID');
+    try {
+        return await requestDatalayerAPI({
+            url: `${baseUrl}${API_BASE_PATHS.IAM}/secrets/${secretId}`,
+            method: 'GET',
+            token,
+        });
+    }
+    catch (error) {
+        if (error.response?.status === 404) {
+            throw new Error(`Secret '${secretId}' not found.`);
+        }
+        throw error;
+    }
+};
+/**
+ * Update a specific secret.
+ * Updates the configuration of an existing secret.
+ *
+ * @param token - Authentication token
+ * @param secretId - Secret unique identifier
+ * @param data - Update data
+ * @param baseUrl - Base URL for IAM service
+ * @returns Updated secret data
+ *
+ * @example
+ * ```typescript
+ * const response = await updateSecret(token, 'secret-id-123', {
+ *   description: 'Updated description',
+ *   value: 'new-password'
+ * });
+ * ```
+ */
+export const updateSecret = async (token, secretId, data, baseUrl = DEFAULT_SERVICE_URLS.IAM) => {
+    validateToken(token);
+    validateRequiredString(secretId, 'Secret ID');
+    // Base64 encode value if provided
+    const requestBody = { ...data };
+    if (data.value) {
+        requestBody.value = encodeValue(data.value);
+    }
+    try {
+        return await requestDatalayerAPI({
+            url: `${baseUrl}${API_BASE_PATHS.IAM}/secrets/${secretId}`,
+            method: 'PUT',
+            body: requestBody,
+            token,
+        });
+    }
+    catch (error) {
+        if (error.response?.status === 404) {
+            throw new Error(`Secret '${secretId}' not found.`);
+        }
+        throw error;
+    }
+};
+/**
+ * Delete a specific secret.
+ * Removes a secret configuration and its encrypted data.
+ *
+ * @param token - Authentication token
+ * @param secretId - Secret unique identifier
+ * @param baseUrl - Base URL for IAM service
+ *
+ * @example
+ * ```typescript
+ * await deleteSecret(token, 'secret-id-123');
+ * ```
+ */
+export const deleteSecret = async (token, secretId, baseUrl = DEFAULT_SERVICE_URLS.IAM) => {
+    validateToken(token);
+    validateRequiredString(secretId, 'Secret ID');
+    try {
+        await requestDatalayerAPI({
+            url: `${baseUrl}${API_BASE_PATHS.IAM}/secrets/${secretId}`,
+            method: 'DELETE',
+            token,
+        });
+    }
+    catch (error) {
+        if (error.response?.status === 404) {
+            throw new Error(`Secret '${secretId}' not found.`);
+        }
+        throw error;
+    }
+};