@mitralab.io/sdk-core 0.2.0-beta.0 → 0.2.0-beta.1

package/dist/index.cjs

@@ -848,24 +848,25 @@ function expectIntegrationTemplate(value, context, errors = defaultSdkCoreErrorF
     expectIntegrationLoginConfig(template.loginConfig, `${context} loginConfig`, errors);
   }
   expectIntegrationRequestConfig(template.requestConfig, `${context} requestConfig`, errors);
-  expectObjectArray(template.fieldsSchema, `${context} fieldsSchema`, errors).forEach(
-    (field, position) => {
-      const fieldContext = `${context} field ${position}`;
-      if (typeof field.key !== "string") invalidField(fieldContext, "key", errors);
-      if (typeof field.label !== "string") invalidField(fieldContext, "label", errors);
-      if (!isOneOf(field.type, ["url", "text", "secret"])) {
-        invalidField(fieldContext, "type", errors);
-      }
-      if (typeof field.required !== "boolean") invalidField(fieldContext, "required", errors);
-      if (!isNullableString(field.placeholder)) invalidField(fieldContext, "placeholder", errors);
-      if (!isNullableString(field.default)) invalidField(fieldContext, "default", errors);
-    }
-  );
+  expectIntegrationFieldsSchema(template.fieldsSchema, `${context} fieldsSchema`, errors);
   if (!isNullableString(template.documentationUrl)) {
     invalidField(context, "documentationUrl", errors);
   }
   return template;
 }
+function expectIntegrationFieldsSchema(value, context, errors) {
+  expectObjectArray(value, context, errors).forEach((field, position) => {
+    const fieldContext = `${context} field ${position}`;
+    if (typeof field.key !== "string") invalidField(fieldContext, "key", errors);
+    if (typeof field.label !== "string") invalidField(fieldContext, "label", errors);
+    if (!isOneOf(field.type, ["url", "text", "secret"])) {
+      invalidField(fieldContext, "type", errors);
+    }
+    if (typeof field.required !== "boolean") invalidField(fieldContext, "required", errors);
+    if (!isNullableString(field.placeholder)) invalidField(fieldContext, "placeholder", errors);
+    if (!isNullableString(field.default)) invalidField(fieldContext, "default", errors);
+  });
+}
 function expectIntegrationLoginConfig(value, context, errors) {
   const config = expectObject(value, context, errors);
   if (!isNullableString(config.url)) invalidField(context, "url", errors);
@@ -912,13 +913,33 @@ function expectIntegrationRequestConfig(value, context, errors) {
     });
   }
 }
+function expectInlineDefinition(config, context, errors) {
+  if (hasOwn(config, "fieldsSchemaInline") && config.fieldsSchemaInline !== null) {
+    expectIntegrationFieldsSchema(
+      config.fieldsSchemaInline,
+      `${context} fieldsSchemaInline`,
+      errors
+    );
+  }
+  if (hasOwn(config, "requestConfigInline") && config.requestConfigInline !== null) {
+    expectIntegrationRequestConfig(
+      config.requestConfigInline,
+      `${context} requestConfigInline`,
+      errors
+    );
+  }
+  if (hasOwn(config, "loginConfigInline") && config.loginConfigInline !== null) {
+    expectIntegrationLoginConfig(config.loginConfigInline, `${context} loginConfigInline`, errors);
+  }
+}
 function expectTemplateConfigSummary(value, context, errors = defaultSdkCoreErrorFactory) {
   const config = expectObject(value, context, errors);
   if (typeof config.id !== "string") invalidField(context, "id", errors);
   if (!isNullableString(config.appId)) invalidField(context, "appId", errors);
   if (!isNullableInteger(config.legacyId)) invalidField(context, "legacyId", errors);
-  if (typeof config.templateId !== "string") invalidField(context, "templateId", errors);
+  if (!isNullableString(config.templateId)) invalidField(context, "templateId", errors);
   if (typeof config.alias !== "string") invalidField(context, "alias", errors);
+  expectInlineDefinition(config, context, errors);
   if (config.status !== null && !isOneOf(config.status, ["unchecked", "connected", "error"])) {
     invalidField(context, "status", errors);
   }

package/dist/index.d.cts

@@ -390,12 +390,26 @@ interface FunctionDefinition {
     createdAt: string | null;
     updatedAt: string;
 }
+/**
+ * Creates an integration config from a catalog template or from an inline definition.
+ *
+ * Send exactly one of the two: either `templateId`, or the inline definition carried by
+ * `fieldsSchemaInline` and `requestConfigInline` with the optional `loginConfigInline`. Sending
+ * both or neither is rejected by the producer; Core does not check it locally. An inline
+ * definition connects a provider that has no template in the catalog.
+ */
 interface TemplateConfigCreateInput {
-    /** Integration template UUID. */
-    templateId: string;
+    /** Integration template UUID. Omitted when the inline definition is sent. */
+    templateId?: string | null;
     /** App-unique alias used by proxy execution. */
     alias: string;
     legacyId?: number;
+    /** Inline field definitions, in the same shape as a template `fieldsSchema`. */
+    fieldsSchemaInline?: IntegrationFieldSchemaInput[];
+    /** Inline header and credential placement rules, in the same shape as a template. */
+    requestConfigInline?: IntegrationRequestConfig;
+    /** Inline login handshake. Null when the provider authenticates on the request itself. */
+    loginConfigInline?: IntegrationLoginConfig | null;
     /** Complete credential and configuration map. Values are write-only. */
     values: Record<string, JsonValue>;
 }
@@ -422,8 +436,13 @@ interface TemplateConfigSummary {
     id: string;
     appId: string | null;
     legacyId: number | null;
-    templateId: string;
+    /** Null on a config created from an inline definition. */
+    templateId: string | null;
     alias: string;
+    /** Inline definition echoed back. Absent or null on a template-backed config. */
+    fieldsSchemaInline?: IntegrationFieldSchema[] | null;
+    requestConfigInline?: IntegrationRequestConfig | null;
+    loginConfigInline?: IntegrationLoginConfig | null;
     status: IntegrationConnectionStatus | null;
     lastCheckedAt: string | null;
 }
@@ -440,8 +459,21 @@ interface ListTemplateConfigsOptions {
     size?: number;
     sort?: string;
 }
+/**
+ * Tests credentials against a catalog template or against an inline definition.
+ *
+ * Follows the same exclusivity as `TemplateConfigCreateInput`: exactly one of `templateId` or the
+ * inline definition, checked by the producer and not by Core. Nothing is stored either way.
+ */
 interface TestCredentialsInput {
-    templateId: string;
+    /** Integration template UUID. Omitted when the inline definition is sent. */
+    templateId?: string | null;
+    /** Inline field definitions, in the same shape as a template `fieldsSchema`. */
+    fieldsSchemaInline?: IntegrationFieldSchemaInput[];
+    /** Inline header and credential placement rules, in the same shape as a template. */
+    requestConfigInline?: IntegrationRequestConfig;
+    /** Inline login handshake. Null when the provider authenticates on the request itself. */
+    loginConfigInline?: IntegrationLoginConfig | null;
     values: Record<string, JsonValue>;
 }
 interface ConnectionTestResult {
@@ -964,6 +996,8 @@ interface IntegrationFieldSchema {
     placeholder: string | null;
     default: string | null;
 }
+/** Inline field authoring shape. The producer stores an omitted `placeholder` or `default` as null. */
+type IntegrationFieldSchemaInput = Omit<IntegrationFieldSchema, "placeholder" | "default"> & Partial<Pick<IntegrationFieldSchema, "placeholder" | "default">>;
 interface IntegrationTemplate extends IntegrationTemplateSummary {
     loginConfig: IntegrationLoginConfig | null;
     requestConfig: IntegrationRequestConfig;
@@ -1340,7 +1374,12 @@ interface FunctionsAdminModule {
 declare function createFunctionsAdminModule(transport: Transport, errors?: SdkCoreErrorFactory): FunctionsAdminModule;
 
 interface IntegrationAdminModule {
-    /** Creates one integration config. Secret values are write-only. */
+    /**
+     * Creates one integration config from a catalog template or from an inline definition.
+     *
+     * Secret values are write-only. Send `templateId` or the inline definition, never both: the
+     * exclusivity is the producer's, so Core forwards whatever the caller sends.
+     */
     create(input: TemplateConfigCreateInput): Promise<TemplateConfig>;
     /** Updates one config. Omitting `values` preserves stored credentials. */
     update(id: string, input: Omit<TemplateConfigUpdateInput, "configId">): Promise<TemplateConfig>;
@@ -1351,6 +1390,7 @@ interface IntegrationAdminModule {
      *
      * The whole batch is validated first, then items run in order, NOT atomically: read `results`
      * for the outcome of each one. `values` hold credentials and never come back in any response.
+     * Each item independently chooses a catalog template or an inline definition.
      */
     bulkCreate(configs: TemplateConfigCreateInput[]): Promise<TemplateConfigBulkResult>;
     /**
@@ -1363,7 +1403,7 @@ interface IntegrationAdminModule {
     bulkUpdate(configs: TemplateConfigUpdateInput[]): Promise<TemplateConfigBulkResult>;
     /** Deletes 1 to 100 template configs by id, in order and NOT atomically. */
     bulkDelete(configIds: string[]): Promise<TemplateConfigBulkResult>;
-    /** Tests provisional credentials against a template without storing anything. */
+    /** Tests provisional credentials against a template or inline definition, storing nothing. */
     testCredentials(request: TestCredentialsInput): Promise<ConnectionTestResult>;
     /** Tests a stored template config using the credentials it already holds. */
     testConfig(configId: string): Promise<ConnectionTestResult>;
@@ -1816,4 +1856,4 @@ declare function expectPage<T extends object>(value: unknown, context: string, e
 declare function expectLegacyPage<T extends object>(value: unknown, context: string, errors?: SdkCoreErrorFactory, validateItem?: (value: unknown, context: string, errors: SdkCoreErrorFactory) => T): LegacyPage<T>;
 declare function expectEmpty(value: unknown, context: string, errors?: SdkCoreErrorFactory): void;
 
-export { type AgentBulkDeleteResult, type AgentConnection, type AgentConnectionCreateInput, type AgentConnectionsModule, type AgentCredentialsModule, type AgentDefinition, type AgentInput, type AgentMessage, type AgentModel, type AgentQueueItem, type AgentSendAndWaitOptions, type AgentSendOptions, type AgentSessionTransport, type AgentTask, type AgentTaskCreateInput, type AgentTaskEvent, type AgentTaskEventConnection, type AgentTaskEventObserver, type AgentTaskEventSource, type AgentTaskInput, type AgentTaskListOptions, type AgentTaskSession, type AgentTaskSessionEventMap, type AgentTaskSessionManager, type AgentTaskSessionManagerOptions, type AgentTaskSessionOptions, type AgentTaskSessionStatus, AgentTaskTurnError, type AgentTasksModule, type AgentTasksWithSessions, type AgentTimelineItem, type AgentToolEvent, type AgentTurnResult, type AgentUpdateItem, type AgentsModule, type AppColor, type AppContext, type AppCreateInput, type AppDefinition, type AppDeploy, type AppDomain, type AppFiles, type AppGetOptions, type AppListOptions, type AppMember, type AppPublishOptions, type AppSummary, type AppUpdateInput, type AppVersion, type AppVersionStatus, type AppsModule, type AuthModule, type AuthenticationResult, type BatchExecution, type BatchStatementResult, type BulkUnsubscribeResult, type ColumnInput, type ConnectionConfig, type ConnectionConfigResponse, type ConnectionTestResult, type ContextModule, type ContextModuleDependencies, type CopilotProvider, type CredentialStatus, type CustomQueriesModule, type CustomQueryDefinition, type CustomQueryInput, type CustomQuerySummary, type CustomQueryUpdateInput, type DataSourceBulkItemResult, type DataSourceBulkResult, type DataSourceCreateInput, type DataSourceDbType, type DataSourceDefinition, type DataSourceInstanceType, type DataSourceUpdateInput, type DataSourcesModule, type DdlStatement, type DeviceAuthorization, type DmlStatement, type EmptyFunctionInput, type EntitiesModule, type EntitiesProxy, type EntityListOptions, type EntityListResponse, type EntityTable, type ExistingAgentTaskSessionOptions, type FunctionBulkCreateInput, type FunctionBulkDeleteInput, type FunctionBulkDeleteResult, type FunctionBulkPatchInput, type FunctionBulkPatchItem, type FunctionBulkUpdateItem, type FunctionCreateInput, type FunctionDefinition, type FunctionExecution, type FunctionListOptions, type FunctionPatchInput, type FunctionRuntime, type FunctionSecrets, type FunctionSummary, type FunctionUpdateInput, type FunctionVersion, type FunctionVersionListOptions, type FunctionVisibility, type FunctionsAdminModule, type FunctionsModule, type FunctionsModuleOptions, type HttpMethod, type ImportColumnMapping, type ImportDefinition, type ImportExecution, type ImportExecutionListOptions, type ImportInput, type ImportProcessing, type ImportSchedule, type ImportSource, type ImportSourceResponse, type ImportTarget, type ImportsModule, type IntegrationAdminModule, type IntegrationConnectionStatus, type IntegrationCredentialRule, type IntegrationExecution, type IntegrationFieldSchema, type IntegrationLoginConfig, type IntegrationModule, type IntegrationProxyMode, type IntegrationRequestConfig, type IntegrationResource, type IntegrationResourceInput, type IntegrationResourceParam, type IntegrationResourceSummary, type IntegrationResourceUpdateInput, type IntegrationResourcesModule, type IntegrationTemplate, type IntegrationTemplateSummary, type IntegrationTemplateType, type IntegrationTemplatesModule, type IntegrationTokenExtraction, type InviteAppUserInput, type InvocationType, type JsonValue, type LegacyPage, type ListTablesOptions, type ListTemplateConfigsOptions, type MembersModule, type MessageAccepted, type MessengerModule, type NewAgentTaskSessionOptions, type OAuthExchangeInput, type OAuthStartResult, type Page, type PageOptions, type PlanPrice, type ProviderCredentialStatus, type ProxyInput, type ProxyResult, type PublicFunctionAsyncResult, type PublicFunctionResult, type PublicFunctionsModule, type QueriesModule, type QueryParamPrimitive, type QueryParamValue, type QueryResult, type SchemaModule, type SchemaScope, type SchemaTables, type SdkCore, SdkCoreConfigurationError, type SdkCoreErrorFactory, type SdkCoreOptions, SdkCoreResponseError, type SdkCoreTransports, type SqlModule, type TableColumn, type TableDefinition, type TableForeignKey, type TemplateConfig, type TemplateConfigBulkItemResult, type TemplateConfigBulkResult, type TemplateConfigCreateInput, type TemplateConfigPage, type TemplateConfigSummary, type TemplateConfigUpdateInput, type Tenant, type TestCredentialsInput, type Transport, type TransportRequestOptions, type User, type UserPlan, type WorkflowDefinition, type WorkflowExecution, type WorkflowInput, type WorkflowSummary, type WorkflowsModule, createAgentConnectionsModule, createAgentCredentialsModule, createAgentTaskSessionManager, createAgentTasksModule, createAgentsModule, createAppsModule, createAuthModule, createContextModule, createCustomQueriesModule, createDataSourcesModule, createEntitiesModule, createFunctionsAdminModule, createFunctionsModule, createImportsModule, createIntegrationAdminModule, createIntegrationModule, createIntegrationResourcesModule, createIntegrationTemplatesModule, createMembersModule, createMessengerModule, createPublicFunctionsModule, createQueriesModule, createSchemaModule, createSdkCore, createSqlModule, createWorkflowsModule, defaultSdkCoreErrorFactory, encodePathSegment, expectEmpty, expectLegacyPage, expectNullableObject, expectObject, expectObjectArray, expectPage, expectStringArray, toAgentTimelineItem, withAgentTaskSessions };
+export { type AgentBulkDeleteResult, type AgentConnection, type AgentConnectionCreateInput, type AgentConnectionsModule, type AgentCredentialsModule, type AgentDefinition, type AgentInput, type AgentMessage, type AgentModel, type AgentQueueItem, type AgentSendAndWaitOptions, type AgentSendOptions, type AgentSessionTransport, type AgentTask, type AgentTaskCreateInput, type AgentTaskEvent, type AgentTaskEventConnection, type AgentTaskEventObserver, type AgentTaskEventSource, type AgentTaskInput, type AgentTaskListOptions, type AgentTaskSession, type AgentTaskSessionEventMap, type AgentTaskSessionManager, type AgentTaskSessionManagerOptions, type AgentTaskSessionOptions, type AgentTaskSessionStatus, AgentTaskTurnError, type AgentTasksModule, type AgentTasksWithSessions, type AgentTimelineItem, type AgentToolEvent, type AgentTurnResult, type AgentUpdateItem, type AgentsModule, type AppColor, type AppContext, type AppCreateInput, type AppDefinition, type AppDeploy, type AppDomain, type AppFiles, type AppGetOptions, type AppListOptions, type AppMember, type AppPublishOptions, type AppSummary, type AppUpdateInput, type AppVersion, type AppVersionStatus, type AppsModule, type AuthModule, type AuthenticationResult, type BatchExecution, type BatchStatementResult, type BulkUnsubscribeResult, type ColumnInput, type ConnectionConfig, type ConnectionConfigResponse, type ConnectionTestResult, type ContextModule, type ContextModuleDependencies, type CopilotProvider, type CredentialStatus, type CustomQueriesModule, type CustomQueryDefinition, type CustomQueryInput, type CustomQuerySummary, type CustomQueryUpdateInput, type DataSourceBulkItemResult, type DataSourceBulkResult, type DataSourceCreateInput, type DataSourceDbType, type DataSourceDefinition, type DataSourceInstanceType, type DataSourceUpdateInput, type DataSourcesModule, type DdlStatement, type DeviceAuthorization, type DmlStatement, type EmptyFunctionInput, type EntitiesModule, type EntitiesProxy, type EntityListOptions, type EntityListResponse, type EntityTable, type ExistingAgentTaskSessionOptions, type FunctionBulkCreateInput, type FunctionBulkDeleteInput, type FunctionBulkDeleteResult, type FunctionBulkPatchInput, type FunctionBulkPatchItem, type FunctionBulkUpdateItem, type FunctionCreateInput, type FunctionDefinition, type FunctionExecution, type FunctionListOptions, type FunctionPatchInput, type FunctionRuntime, type FunctionSecrets, type FunctionSummary, type FunctionUpdateInput, type FunctionVersion, type FunctionVersionListOptions, type FunctionVisibility, type FunctionsAdminModule, type FunctionsModule, type FunctionsModuleOptions, type HttpMethod, type ImportColumnMapping, type ImportDefinition, type ImportExecution, type ImportExecutionListOptions, type ImportInput, type ImportProcessing, type ImportSchedule, type ImportSource, type ImportSourceResponse, type ImportTarget, type ImportsModule, type IntegrationAdminModule, type IntegrationConnectionStatus, type IntegrationCredentialRule, type IntegrationExecution, type IntegrationFieldSchema, type IntegrationFieldSchemaInput, type IntegrationLoginConfig, type IntegrationModule, type IntegrationProxyMode, type IntegrationRequestConfig, type IntegrationResource, type IntegrationResourceInput, type IntegrationResourceParam, type IntegrationResourceSummary, type IntegrationResourceUpdateInput, type IntegrationResourcesModule, type IntegrationTemplate, type IntegrationTemplateSummary, type IntegrationTemplateType, type IntegrationTemplatesModule, type IntegrationTokenExtraction, type InviteAppUserInput, type InvocationType, type JsonValue, type LegacyPage, type ListTablesOptions, type ListTemplateConfigsOptions, type MembersModule, type MessageAccepted, type MessengerModule, type NewAgentTaskSessionOptions, type OAuthExchangeInput, type OAuthStartResult, type Page, type PageOptions, type PlanPrice, type ProviderCredentialStatus, type ProxyInput, type ProxyResult, type PublicFunctionAsyncResult, type PublicFunctionResult, type PublicFunctionsModule, type QueriesModule, type QueryParamPrimitive, type QueryParamValue, type QueryResult, type SchemaModule, type SchemaScope, type SchemaTables, type SdkCore, SdkCoreConfigurationError, type SdkCoreErrorFactory, type SdkCoreOptions, SdkCoreResponseError, type SdkCoreTransports, type SqlModule, type TableColumn, type TableDefinition, type TableForeignKey, type TemplateConfig, type TemplateConfigBulkItemResult, type TemplateConfigBulkResult, type TemplateConfigCreateInput, type TemplateConfigPage, type TemplateConfigSummary, type TemplateConfigUpdateInput, type Tenant, type TestCredentialsInput, type Transport, type TransportRequestOptions, type User, type UserPlan, type WorkflowDefinition, type WorkflowExecution, type WorkflowInput, type WorkflowSummary, type WorkflowsModule, createAgentConnectionsModule, createAgentCredentialsModule, createAgentTaskSessionManager, createAgentTasksModule, createAgentsModule, createAppsModule, createAuthModule, createContextModule, createCustomQueriesModule, createDataSourcesModule, createEntitiesModule, createFunctionsAdminModule, createFunctionsModule, createImportsModule, createIntegrationAdminModule, createIntegrationModule, createIntegrationResourcesModule, createIntegrationTemplatesModule, createMembersModule, createMessengerModule, createPublicFunctionsModule, createQueriesModule, createSchemaModule, createSdkCore, createSqlModule, createWorkflowsModule, defaultSdkCoreErrorFactory, encodePathSegment, expectEmpty, expectLegacyPage, expectNullableObject, expectObject, expectObjectArray, expectPage, expectStringArray, toAgentTimelineItem, withAgentTaskSessions };

package/dist/index.d.ts

@@ -390,12 +390,26 @@ interface FunctionDefinition {
     createdAt: string | null;
     updatedAt: string;
 }
+/**
+ * Creates an integration config from a catalog template or from an inline definition.
+ *
+ * Send exactly one of the two: either `templateId`, or the inline definition carried by
+ * `fieldsSchemaInline` and `requestConfigInline` with the optional `loginConfigInline`. Sending
+ * both or neither is rejected by the producer; Core does not check it locally. An inline
+ * definition connects a provider that has no template in the catalog.
+ */
 interface TemplateConfigCreateInput {
-    /** Integration template UUID. */
-    templateId: string;
+    /** Integration template UUID. Omitted when the inline definition is sent. */
+    templateId?: string | null;
     /** App-unique alias used by proxy execution. */
     alias: string;
     legacyId?: number;
+    /** Inline field definitions, in the same shape as a template `fieldsSchema`. */
+    fieldsSchemaInline?: IntegrationFieldSchemaInput[];
+    /** Inline header and credential placement rules, in the same shape as a template. */
+    requestConfigInline?: IntegrationRequestConfig;
+    /** Inline login handshake. Null when the provider authenticates on the request itself. */
+    loginConfigInline?: IntegrationLoginConfig | null;
     /** Complete credential and configuration map. Values are write-only. */
     values: Record<string, JsonValue>;
 }
@@ -422,8 +436,13 @@ interface TemplateConfigSummary {
     id: string;
     appId: string | null;
     legacyId: number | null;
-    templateId: string;
+    /** Null on a config created from an inline definition. */
+    templateId: string | null;
     alias: string;
+    /** Inline definition echoed back. Absent or null on a template-backed config. */
+    fieldsSchemaInline?: IntegrationFieldSchema[] | null;
+    requestConfigInline?: IntegrationRequestConfig | null;
+    loginConfigInline?: IntegrationLoginConfig | null;
     status: IntegrationConnectionStatus | null;
     lastCheckedAt: string | null;
 }
@@ -440,8 +459,21 @@ interface ListTemplateConfigsOptions {
     size?: number;
     sort?: string;
 }
+/**
+ * Tests credentials against a catalog template or against an inline definition.
+ *
+ * Follows the same exclusivity as `TemplateConfigCreateInput`: exactly one of `templateId` or the
+ * inline definition, checked by the producer and not by Core. Nothing is stored either way.
+ */
 interface TestCredentialsInput {
-    templateId: string;
+    /** Integration template UUID. Omitted when the inline definition is sent. */
+    templateId?: string | null;
+    /** Inline field definitions, in the same shape as a template `fieldsSchema`. */
+    fieldsSchemaInline?: IntegrationFieldSchemaInput[];
+    /** Inline header and credential placement rules, in the same shape as a template. */
+    requestConfigInline?: IntegrationRequestConfig;
+    /** Inline login handshake. Null when the provider authenticates on the request itself. */
+    loginConfigInline?: IntegrationLoginConfig | null;
     values: Record<string, JsonValue>;
 }
 interface ConnectionTestResult {
@@ -964,6 +996,8 @@ interface IntegrationFieldSchema {
     placeholder: string | null;
     default: string | null;
 }
+/** Inline field authoring shape. The producer stores an omitted `placeholder` or `default` as null. */
+type IntegrationFieldSchemaInput = Omit<IntegrationFieldSchema, "placeholder" | "default"> & Partial<Pick<IntegrationFieldSchema, "placeholder" | "default">>;
 interface IntegrationTemplate extends IntegrationTemplateSummary {
     loginConfig: IntegrationLoginConfig | null;
     requestConfig: IntegrationRequestConfig;
@@ -1340,7 +1374,12 @@ interface FunctionsAdminModule {
 declare function createFunctionsAdminModule(transport: Transport, errors?: SdkCoreErrorFactory): FunctionsAdminModule;
 
 interface IntegrationAdminModule {
-    /** Creates one integration config. Secret values are write-only. */
+    /**
+     * Creates one integration config from a catalog template or from an inline definition.
+     *
+     * Secret values are write-only. Send `templateId` or the inline definition, never both: the
+     * exclusivity is the producer's, so Core forwards whatever the caller sends.
+     */
     create(input: TemplateConfigCreateInput): Promise<TemplateConfig>;
     /** Updates one config. Omitting `values` preserves stored credentials. */
     update(id: string, input: Omit<TemplateConfigUpdateInput, "configId">): Promise<TemplateConfig>;
@@ -1351,6 +1390,7 @@ interface IntegrationAdminModule {
      *
      * The whole batch is validated first, then items run in order, NOT atomically: read `results`
      * for the outcome of each one. `values` hold credentials and never come back in any response.
+     * Each item independently chooses a catalog template or an inline definition.
      */
     bulkCreate(configs: TemplateConfigCreateInput[]): Promise<TemplateConfigBulkResult>;
     /**
@@ -1363,7 +1403,7 @@ interface IntegrationAdminModule {
     bulkUpdate(configs: TemplateConfigUpdateInput[]): Promise<TemplateConfigBulkResult>;
     /** Deletes 1 to 100 template configs by id, in order and NOT atomically. */
     bulkDelete(configIds: string[]): Promise<TemplateConfigBulkResult>;
-    /** Tests provisional credentials against a template without storing anything. */
+    /** Tests provisional credentials against a template or inline definition, storing nothing. */
     testCredentials(request: TestCredentialsInput): Promise<ConnectionTestResult>;
     /** Tests a stored template config using the credentials it already holds. */
     testConfig(configId: string): Promise<ConnectionTestResult>;
@@ -1816,4 +1856,4 @@ declare function expectPage<T extends object>(value: unknown, context: string, e
 declare function expectLegacyPage<T extends object>(value: unknown, context: string, errors?: SdkCoreErrorFactory, validateItem?: (value: unknown, context: string, errors: SdkCoreErrorFactory) => T): LegacyPage<T>;
 declare function expectEmpty(value: unknown, context: string, errors?: SdkCoreErrorFactory): void;
 
-export { type AgentBulkDeleteResult, type AgentConnection, type AgentConnectionCreateInput, type AgentConnectionsModule, type AgentCredentialsModule, type AgentDefinition, type AgentInput, type AgentMessage, type AgentModel, type AgentQueueItem, type AgentSendAndWaitOptions, type AgentSendOptions, type AgentSessionTransport, type AgentTask, type AgentTaskCreateInput, type AgentTaskEvent, type AgentTaskEventConnection, type AgentTaskEventObserver, type AgentTaskEventSource, type AgentTaskInput, type AgentTaskListOptions, type AgentTaskSession, type AgentTaskSessionEventMap, type AgentTaskSessionManager, type AgentTaskSessionManagerOptions, type AgentTaskSessionOptions, type AgentTaskSessionStatus, AgentTaskTurnError, type AgentTasksModule, type AgentTasksWithSessions, type AgentTimelineItem, type AgentToolEvent, type AgentTurnResult, type AgentUpdateItem, type AgentsModule, type AppColor, type AppContext, type AppCreateInput, type AppDefinition, type AppDeploy, type AppDomain, type AppFiles, type AppGetOptions, type AppListOptions, type AppMember, type AppPublishOptions, type AppSummary, type AppUpdateInput, type AppVersion, type AppVersionStatus, type AppsModule, type AuthModule, type AuthenticationResult, type BatchExecution, type BatchStatementResult, type BulkUnsubscribeResult, type ColumnInput, type ConnectionConfig, type ConnectionConfigResponse, type ConnectionTestResult, type ContextModule, type ContextModuleDependencies, type CopilotProvider, type CredentialStatus, type CustomQueriesModule, type CustomQueryDefinition, type CustomQueryInput, type CustomQuerySummary, type CustomQueryUpdateInput, type DataSourceBulkItemResult, type DataSourceBulkResult, type DataSourceCreateInput, type DataSourceDbType, type DataSourceDefinition, type DataSourceInstanceType, type DataSourceUpdateInput, type DataSourcesModule, type DdlStatement, type DeviceAuthorization, type DmlStatement, type EmptyFunctionInput, type EntitiesModule, type EntitiesProxy, type EntityListOptions, type EntityListResponse, type EntityTable, type ExistingAgentTaskSessionOptions, type FunctionBulkCreateInput, type FunctionBulkDeleteInput, type FunctionBulkDeleteResult, type FunctionBulkPatchInput, type FunctionBulkPatchItem, type FunctionBulkUpdateItem, type FunctionCreateInput, type FunctionDefinition, type FunctionExecution, type FunctionListOptions, type FunctionPatchInput, type FunctionRuntime, type FunctionSecrets, type FunctionSummary, type FunctionUpdateInput, type FunctionVersion, type FunctionVersionListOptions, type FunctionVisibility, type FunctionsAdminModule, type FunctionsModule, type FunctionsModuleOptions, type HttpMethod, type ImportColumnMapping, type ImportDefinition, type ImportExecution, type ImportExecutionListOptions, type ImportInput, type ImportProcessing, type ImportSchedule, type ImportSource, type ImportSourceResponse, type ImportTarget, type ImportsModule, type IntegrationAdminModule, type IntegrationConnectionStatus, type IntegrationCredentialRule, type IntegrationExecution, type IntegrationFieldSchema, type IntegrationLoginConfig, type IntegrationModule, type IntegrationProxyMode, type IntegrationRequestConfig, type IntegrationResource, type IntegrationResourceInput, type IntegrationResourceParam, type IntegrationResourceSummary, type IntegrationResourceUpdateInput, type IntegrationResourcesModule, type IntegrationTemplate, type IntegrationTemplateSummary, type IntegrationTemplateType, type IntegrationTemplatesModule, type IntegrationTokenExtraction, type InviteAppUserInput, type InvocationType, type JsonValue, type LegacyPage, type ListTablesOptions, type ListTemplateConfigsOptions, type MembersModule, type MessageAccepted, type MessengerModule, type NewAgentTaskSessionOptions, type OAuthExchangeInput, type OAuthStartResult, type Page, type PageOptions, type PlanPrice, type ProviderCredentialStatus, type ProxyInput, type ProxyResult, type PublicFunctionAsyncResult, type PublicFunctionResult, type PublicFunctionsModule, type QueriesModule, type QueryParamPrimitive, type QueryParamValue, type QueryResult, type SchemaModule, type SchemaScope, type SchemaTables, type SdkCore, SdkCoreConfigurationError, type SdkCoreErrorFactory, type SdkCoreOptions, SdkCoreResponseError, type SdkCoreTransports, type SqlModule, type TableColumn, type TableDefinition, type TableForeignKey, type TemplateConfig, type TemplateConfigBulkItemResult, type TemplateConfigBulkResult, type TemplateConfigCreateInput, type TemplateConfigPage, type TemplateConfigSummary, type TemplateConfigUpdateInput, type Tenant, type TestCredentialsInput, type Transport, type TransportRequestOptions, type User, type UserPlan, type WorkflowDefinition, type WorkflowExecution, type WorkflowInput, type WorkflowSummary, type WorkflowsModule, createAgentConnectionsModule, createAgentCredentialsModule, createAgentTaskSessionManager, createAgentTasksModule, createAgentsModule, createAppsModule, createAuthModule, createContextModule, createCustomQueriesModule, createDataSourcesModule, createEntitiesModule, createFunctionsAdminModule, createFunctionsModule, createImportsModule, createIntegrationAdminModule, createIntegrationModule, createIntegrationResourcesModule, createIntegrationTemplatesModule, createMembersModule, createMessengerModule, createPublicFunctionsModule, createQueriesModule, createSchemaModule, createSdkCore, createSqlModule, createWorkflowsModule, defaultSdkCoreErrorFactory, encodePathSegment, expectEmpty, expectLegacyPage, expectNullableObject, expectObject, expectObjectArray, expectPage, expectStringArray, toAgentTimelineItem, withAgentTaskSessions };
+export { type AgentBulkDeleteResult, type AgentConnection, type AgentConnectionCreateInput, type AgentConnectionsModule, type AgentCredentialsModule, type AgentDefinition, type AgentInput, type AgentMessage, type AgentModel, type AgentQueueItem, type AgentSendAndWaitOptions, type AgentSendOptions, type AgentSessionTransport, type AgentTask, type AgentTaskCreateInput, type AgentTaskEvent, type AgentTaskEventConnection, type AgentTaskEventObserver, type AgentTaskEventSource, type AgentTaskInput, type AgentTaskListOptions, type AgentTaskSession, type AgentTaskSessionEventMap, type AgentTaskSessionManager, type AgentTaskSessionManagerOptions, type AgentTaskSessionOptions, type AgentTaskSessionStatus, AgentTaskTurnError, type AgentTasksModule, type AgentTasksWithSessions, type AgentTimelineItem, type AgentToolEvent, type AgentTurnResult, type AgentUpdateItem, type AgentsModule, type AppColor, type AppContext, type AppCreateInput, type AppDefinition, type AppDeploy, type AppDomain, type AppFiles, type AppGetOptions, type AppListOptions, type AppMember, type AppPublishOptions, type AppSummary, type AppUpdateInput, type AppVersion, type AppVersionStatus, type AppsModule, type AuthModule, type AuthenticationResult, type BatchExecution, type BatchStatementResult, type BulkUnsubscribeResult, type ColumnInput, type ConnectionConfig, type ConnectionConfigResponse, type ConnectionTestResult, type ContextModule, type ContextModuleDependencies, type CopilotProvider, type CredentialStatus, type CustomQueriesModule, type CustomQueryDefinition, type CustomQueryInput, type CustomQuerySummary, type CustomQueryUpdateInput, type DataSourceBulkItemResult, type DataSourceBulkResult, type DataSourceCreateInput, type DataSourceDbType, type DataSourceDefinition, type DataSourceInstanceType, type DataSourceUpdateInput, type DataSourcesModule, type DdlStatement, type DeviceAuthorization, type DmlStatement, type EmptyFunctionInput, type EntitiesModule, type EntitiesProxy, type EntityListOptions, type EntityListResponse, type EntityTable, type ExistingAgentTaskSessionOptions, type FunctionBulkCreateInput, type FunctionBulkDeleteInput, type FunctionBulkDeleteResult, type FunctionBulkPatchInput, type FunctionBulkPatchItem, type FunctionBulkUpdateItem, type FunctionCreateInput, type FunctionDefinition, type FunctionExecution, type FunctionListOptions, type FunctionPatchInput, type FunctionRuntime, type FunctionSecrets, type FunctionSummary, type FunctionUpdateInput, type FunctionVersion, type FunctionVersionListOptions, type FunctionVisibility, type FunctionsAdminModule, type FunctionsModule, type FunctionsModuleOptions, type HttpMethod, type ImportColumnMapping, type ImportDefinition, type ImportExecution, type ImportExecutionListOptions, type ImportInput, type ImportProcessing, type ImportSchedule, type ImportSource, type ImportSourceResponse, type ImportTarget, type ImportsModule, type IntegrationAdminModule, type IntegrationConnectionStatus, type IntegrationCredentialRule, type IntegrationExecution, type IntegrationFieldSchema, type IntegrationFieldSchemaInput, type IntegrationLoginConfig, type IntegrationModule, type IntegrationProxyMode, type IntegrationRequestConfig, type IntegrationResource, type IntegrationResourceInput, type IntegrationResourceParam, type IntegrationResourceSummary, type IntegrationResourceUpdateInput, type IntegrationResourcesModule, type IntegrationTemplate, type IntegrationTemplateSummary, type IntegrationTemplateType, type IntegrationTemplatesModule, type IntegrationTokenExtraction, type InviteAppUserInput, type InvocationType, type JsonValue, type LegacyPage, type ListTablesOptions, type ListTemplateConfigsOptions, type MembersModule, type MessageAccepted, type MessengerModule, type NewAgentTaskSessionOptions, type OAuthExchangeInput, type OAuthStartResult, type Page, type PageOptions, type PlanPrice, type ProviderCredentialStatus, type ProxyInput, type ProxyResult, type PublicFunctionAsyncResult, type PublicFunctionResult, type PublicFunctionsModule, type QueriesModule, type QueryParamPrimitive, type QueryParamValue, type QueryResult, type SchemaModule, type SchemaScope, type SchemaTables, type SdkCore, SdkCoreConfigurationError, type SdkCoreErrorFactory, type SdkCoreOptions, SdkCoreResponseError, type SdkCoreTransports, type SqlModule, type TableColumn, type TableDefinition, type TableForeignKey, type TemplateConfig, type TemplateConfigBulkItemResult, type TemplateConfigBulkResult, type TemplateConfigCreateInput, type TemplateConfigPage, type TemplateConfigSummary, type TemplateConfigUpdateInput, type Tenant, type TestCredentialsInput, type Transport, type TransportRequestOptions, type User, type UserPlan, type WorkflowDefinition, type WorkflowExecution, type WorkflowInput, type WorkflowSummary, type WorkflowsModule, createAgentConnectionsModule, createAgentCredentialsModule, createAgentTaskSessionManager, createAgentTasksModule, createAgentsModule, createAppsModule, createAuthModule, createContextModule, createCustomQueriesModule, createDataSourcesModule, createEntitiesModule, createFunctionsAdminModule, createFunctionsModule, createImportsModule, createIntegrationAdminModule, createIntegrationModule, createIntegrationResourcesModule, createIntegrationTemplatesModule, createMembersModule, createMessengerModule, createPublicFunctionsModule, createQueriesModule, createSchemaModule, createSdkCore, createSqlModule, createWorkflowsModule, defaultSdkCoreErrorFactory, encodePathSegment, expectEmpty, expectLegacyPage, expectNullableObject, expectObject, expectObjectArray, expectPage, expectStringArray, toAgentTimelineItem, withAgentTaskSessions };

package/dist/index.js

@@ -783,24 +783,25 @@ function expectIntegrationTemplate(value, context, errors = defaultSdkCoreErrorF
     expectIntegrationLoginConfig(template.loginConfig, `${context} loginConfig`, errors);
   }
   expectIntegrationRequestConfig(template.requestConfig, `${context} requestConfig`, errors);
-  expectObjectArray(template.fieldsSchema, `${context} fieldsSchema`, errors).forEach(
-    (field, position) => {
-      const fieldContext = `${context} field ${position}`;
-      if (typeof field.key !== "string") invalidField(fieldContext, "key", errors);
-      if (typeof field.label !== "string") invalidField(fieldContext, "label", errors);
-      if (!isOneOf(field.type, ["url", "text", "secret"])) {
-        invalidField(fieldContext, "type", errors);
-      }
-      if (typeof field.required !== "boolean") invalidField(fieldContext, "required", errors);
-      if (!isNullableString(field.placeholder)) invalidField(fieldContext, "placeholder", errors);
-      if (!isNullableString(field.default)) invalidField(fieldContext, "default", errors);
-    }
-  );
+  expectIntegrationFieldsSchema(template.fieldsSchema, `${context} fieldsSchema`, errors);
   if (!isNullableString(template.documentationUrl)) {
     invalidField(context, "documentationUrl", errors);
   }
   return template;
 }
+function expectIntegrationFieldsSchema(value, context, errors) {
+  expectObjectArray(value, context, errors).forEach((field, position) => {
+    const fieldContext = `${context} field ${position}`;
+    if (typeof field.key !== "string") invalidField(fieldContext, "key", errors);
+    if (typeof field.label !== "string") invalidField(fieldContext, "label", errors);
+    if (!isOneOf(field.type, ["url", "text", "secret"])) {
+      invalidField(fieldContext, "type", errors);
+    }
+    if (typeof field.required !== "boolean") invalidField(fieldContext, "required", errors);
+    if (!isNullableString(field.placeholder)) invalidField(fieldContext, "placeholder", errors);
+    if (!isNullableString(field.default)) invalidField(fieldContext, "default", errors);
+  });
+}
 function expectIntegrationLoginConfig(value, context, errors) {
   const config = expectObject(value, context, errors);
   if (!isNullableString(config.url)) invalidField(context, "url", errors);
@@ -847,13 +848,33 @@ function expectIntegrationRequestConfig(value, context, errors) {
     });
   }
 }
+function expectInlineDefinition(config, context, errors) {
+  if (hasOwn(config, "fieldsSchemaInline") && config.fieldsSchemaInline !== null) {
+    expectIntegrationFieldsSchema(
+      config.fieldsSchemaInline,
+      `${context} fieldsSchemaInline`,
+      errors
+    );
+  }
+  if (hasOwn(config, "requestConfigInline") && config.requestConfigInline !== null) {
+    expectIntegrationRequestConfig(
+      config.requestConfigInline,
+      `${context} requestConfigInline`,
+      errors
+    );
+  }
+  if (hasOwn(config, "loginConfigInline") && config.loginConfigInline !== null) {
+    expectIntegrationLoginConfig(config.loginConfigInline, `${context} loginConfigInline`, errors);
+  }
+}
 function expectTemplateConfigSummary(value, context, errors = defaultSdkCoreErrorFactory) {
   const config = expectObject(value, context, errors);
   if (typeof config.id !== "string") invalidField(context, "id", errors);
   if (!isNullableString(config.appId)) invalidField(context, "appId", errors);
   if (!isNullableInteger(config.legacyId)) invalidField(context, "legacyId", errors);
-  if (typeof config.templateId !== "string") invalidField(context, "templateId", errors);
+  if (!isNullableString(config.templateId)) invalidField(context, "templateId", errors);
   if (typeof config.alias !== "string") invalidField(context, "alias", errors);
+  expectInlineDefinition(config, context, errors);
   if (config.status !== null && !isOneOf(config.status, ["unchecked", "connected", "error"])) {
     invalidField(context, "status", errors);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mitralab.io/sdk-core",
-  "version": "0.2.0-beta.0",
+  "version": "0.2.0-beta.1",
   "description": "Environment-neutral contracts and modules shared by Mitra JavaScript SDKs",
   "type": "module",
   "sideEffects": false,