@dpuse/dpuse-shared 0.3.824 → 0.3.829

package/README.md

@@ -186,39 +186,39 @@ _Note: Sonda's Vite reports currently exclude CSS files, since Vite does not gen
 |Chunk/Module/File|Composition|
 |:------ |:-----------|
 | dist/componentConfig.schema-DT3mO5rS.js | 10.2 kB · brotli 2.3 kB |
-|     valibot → dist/index.mjs | `████░░░░░░░░░░░░░░░░` 21.3% |
-|     (unassigned) → [unassigned] | `█░░░░░░░░░░░░░░░░░░░` 5.4% |
-|     src | `█░░░░░░░░░░░░░░░░░░░` 4.3% |
+|     valibot → dist/index.mjs | `████░░░░░░░░░░░░░░░░` 20.6% |
+|     (unassigned) → [unassigned] | `█░░░░░░░░░░░░░░░░░░░` 5.2% |
+|     src | `█░░░░░░░░░░░░░░░░░░░` 4.1% |
 |         componentConfig.schema.ts | `█░░░░░░░░░░░░░░░░░░░` 2.7% |
 |         locale.schema.ts | `░░░░░░░░░░░░░░░░░░░░` 0.8% |
-|         baseConfig.schema.ts | `░░░░░░░░░░░░░░░░░░░░` 0.6% |
+|         baseConfig.schema.ts | `░░░░░░░░░░░░░░░░░░░░` 0.5% |
 |         schema.ts | `░░░░░░░░░░░░░░░░░░░░` 0.2% |
 | dist/dpuse-shared-encoding.es.js | 7.4 kB · brotli 1.3 kB |
-|     src → index.ts | `████░░░░░░░░░░░░░░░░` 19.4% |
-|     (unassigned) → [unassigned] | `█░░░░░░░░░░░░░░░░░░░` 3.0% |
+|     src → index.ts | `████░░░░░░░░░░░░░░░░` 18.8% |
+|     (unassigned) → [unassigned] | `█░░░░░░░░░░░░░░░░░░░` 2.9% |
+| dist/dpuse-shared-errors.es.js | 4.6 kB · brotli 1.6 kB |
+|     src → index.ts | `██░░░░░░░░░░░░░░░░░░` 12.2% |
+|     (unassigned) → [unassigned] | `░░░░░░░░░░░░░░░░░░░░` 1.4% |
 | dist/dpuse-shared-componentModuleConnector.es.js | 3.6 kB · brotli 1.2 kB |
-|     src | `██░░░░░░░░░░░░░░░░░░` 8.6% |
-|         index.ts | `█░░░░░░░░░░░░░░░░░░░` 6.2% |
-|         connectorConfig.schema.ts | `░░░░░░░░░░░░░░░░░░░░` 2.4% |
-|     (unassigned) → [unassigned] | `░░░░░░░░░░░░░░░░░░░░` 2.3% |
-| dist/dpuse-shared-errors.es.js | 3.5 kB · brotli 1.1 kB |
-|     src → index.ts | `██░░░░░░░░░░░░░░░░░░` 9.4% |
-|     (unassigned) → [unassigned] | `░░░░░░░░░░░░░░░░░░░░` 1.3% |
+|     src | `██░░░░░░░░░░░░░░░░░░` 8.3% |
+|         index.ts | `█░░░░░░░░░░░░░░░░░░░` 6.0% |
+|         connectorConfig.schema.ts | `░░░░░░░░░░░░░░░░░░░░` 2.3% |
+|     (unassigned) → [unassigned] | `░░░░░░░░░░░░░░░░░░░░` 2.2% |
 | dist/dpuse-shared-utilities.es.js | 3.5 kB · brotli 1.1 kB |
-|     src → index.ts | `██░░░░░░░░░░░░░░░░░░` 9.2% |
+|     src → index.ts | `██░░░░░░░░░░░░░░░░░░` 8.9% |
 |     (unassigned) → [unassigned] | `░░░░░░░░░░░░░░░░░░░░` 1.4% |
 | dist/dpuse-shared-locale.es.js | 856 B · brotli 330 B |
 |     src → index.ts | `░░░░░░░░░░░░░░░░░░░░` 1.6% |
 |     (unassigned) → [unassigned] | `░░░░░░░░░░░░░░░░░░░░` 0.9% |
 | dist/dpuse-shared-component.es.js | 834 B · brotli 363 B |
-|     src → index.ts | `░░░░░░░░░░░░░░░░░░░░` 1.6% |
+|     src → index.ts | `░░░░░░░░░░░░░░░░░░░░` 1.5% |
 |     (unassigned) → [unassigned] | `░░░░░░░░░░░░░░░░░░░░` 0.9% |
 | dist/dpuse-shared-componentModuleTool.es.js | 784 B · brotli 398 B |
 |     src → index.ts | `░░░░░░░░░░░░░░░░░░░░` 1.7% |
 |     (unassigned) → [unassigned] | `░░░░░░░░░░░░░░░░░░░░` 0.6% |
 | dist/dpuse-shared-componentDataView.es.js | 701 B · brotli 297 B |
 |     src → index.ts | `░░░░░░░░░░░░░░░░░░░░` 1.6% |
-|     (unassigned) → [unassigned] | `░░░░░░░░░░░░░░░░░░░░` 0.5% |
+|     (unassigned) → [unassigned] | `░░░░░░░░░░░░░░░░░░░░` 0.4% |
 | dist/dpuse-shared-componentModulePresenter.es.js | 411 B · brotli 225 B |
 |     (unassigned) → [unassigned] | `░░░░░░░░░░░░░░░░░░░░` 0.8% |
 |     src → presenterConfig.schema.ts | `░░░░░░░░░░░░░░░░░░░░` 0.4% |

package/dist/dpuse-shared-componentModuleConnector.es.js

@@ -26,7 +26,8 @@ var m = o([
 ]), g = u({ label: n }), _ = o([
 	"bidirectional",
 	"destination",
-	"source"
+	"source",
+	"unknown"
 ]), v = u({ label: n }), y = o([
 	"apiKey",
 	"disabled",
@@ -142,7 +143,7 @@ var m = o([
 function O(e) {
 	let t = !1, n = !1;
 	for (let r of e) D.has(r) && (t = !0), E.has(r) && (n = !0);
-	return t && n ? "bidirectional" : t ? "source" : n ? "destination" : "source";
+	return t && n ? "bidirectional" : t ? "source" : n ? "destination" : "unknown";
 }
 var k = (n, r = "en") => {
 	let i = C.find((e) => e.id === n);

package/dist/dpuse-shared-componentModuleConnector.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"dpuse-shared-componentModuleConnector.es.js","names":[],"sources":["../src/component/module/connector/connectorConfig.schema.ts","../src/component/module/connector/index.ts"],"sourcesContent":["/**\n * Defines the configuration metadata for a connector. Used for validation\n * of connector manifests and capability discovery at runtime.\n */\n\n// ── External Dependencies & Registrations\nimport { array, boolean, literal, nullable, number, optional, record, strictObject, string } from 'valibot';\n\n// ── DPUse Framework\nimport { literalUnion } from '@/schema';\nimport { localeLabelSchema } from '@/locale/locale.schema';\nimport { moduleConfigCoreFields } from '@/component/module/moduleConfig.schema';\n\n// ── Schemas - Action Name ────────────────────────────────────────────────────────────────────────────────────────────\n\n// Names of the operations a connector may implement.\nexport const connectorActionNameSchema = literalUnion([\n    'abortOperation',\n    'auditObjectContent',\n    'createObject',\n    'describeConnection',\n    'dropObject',\n    'findObject',\n    'getInfo',\n    'getReadableStream',\n    'getRecord',\n    'listNodes',\n    'previewObject',\n    'removeRecords',\n    'retrieveChunks',\n    'retrieveRecords',\n    'upsertRecords'\n]);\n\n// ── Schemas - Category Configuration ─────────────────────────────────────────────────────────────────────────────────\n\nconst connectorCategoryIdSchema = literalUnion(['application', 'curatedDataset', 'database', 'fileStore']); // Category identifiers used for grouping and filtering connectors.\n\nexport const connectorCategoryConfigSchema = strictObject({\n    label: localeLabelSchema\n});\n\n// ── Schemas - Usage ──────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport const connectorUsageIdSchema = literalUnion(['bidirectional', 'destination', 'source']); // Connector data pipeline usage identifiers.\n\nexport const connectorUsageConfigSchema = strictObject({\n    label: localeLabelSchema\n});\n\n// ── Schemas - Implementation ─────────────────────────────────────────────────────────────────────────────────────────\n\nconst connectorAuthMethodIdSchema = literalUnion(['apiKey', 'disabled', 'oAuth2', 'none']); // Authentication method identifiers supported by a connector implementation.\n\nconst connectorImplementationParametersSchema = record(string(), string()); // One set of implementation parameters, keyed by name.\n\n// A connector implementation variant. A single connector may expose multiple implementations differing by auth method, limits, or vendor-specific behavior.\nconst connectorImplementationSchema = strictObject({\n    authMethodId: connectorAuthMethodIdSchema,\n    activeConnectionCount: optional(number()),\n    canDescribe: optional(boolean()),\n    id: optional(string()),\n    label: optional(localeLabelSchema),\n    maxConnectionCount: nullable(number()),\n    params: optional(array(connectorImplementationParametersSchema))\n});\n\n// ── Schemas - Configuration ──────────────────────────────────────────────────────────────────────────────────────────\n\nexport const connectorConfigSchema = strictObject({\n    ...moduleConfigCoreFields,\n    typeId: literal('connector'),\n    actionNames: array(connectorActionNameSchema),\n    category: nullable(connectorCategoryConfigSchema),\n    categoryId: connectorCategoryIdSchema,\n    implementations: record(string(), connectorImplementationSchema),\n    usage: nullable(connectorUsageConfigSchema),\n    usageId: nullable(connectorUsageIdSchema)\n});\n","// ── External Dependencies & Registrations\nimport type { InferOutput } from 'valibot';\n\n// ── DPUse Framework\nimport type { Component } from '@/component';\nimport type { EngineConnectorActionOptions } from '@/component/module/engine';\nimport type { ToolConfig } from '@/component/module/tool';\nimport type { ConnectionDescriptionConfig, ConnectionNodeConfig, ObjectColumnConfig } from '@/component/connection';\nimport type {\n    connectorActionNameSchema,\n    connectorCategoryConfigSchema,\n    connectorConfigSchema,\n    connectorUsageConfigSchema,\n    connectorUsageIdSchema\n} from '@/component/module/connector/connectorConfig.schema';\nimport type { ContentAuditConfig, InferenceRecord, InferenceSummary, ParsingRecord, PreviewConfig, ValueDelimiterId } from '@/component/dataView';\nimport { createLabelMap, DEFAULT_LOCALE_ID, type LocaleLabel, resolveLabel } from '@/locale/label';\nimport type { LocalisedConfig } from '@/locale';\n\n// ── Schemas ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport { connectorConfigSchema } from '@/component/module/connector/connectorConfig.schema';\n\n// ── Types - Interface ────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport interface ConnectorInterface extends Component {\n    abortController: AbortController | undefined;\n    readonly config: ConnectorConfig;\n    readonly toolConfigs: ToolConfig[];\n    abortOperation?(): void; // Abort the active long running action.\n    auditObjectContent?(options: AuditObjectContentOptions, chunk: (rowCount: number) => void): Promise<AuditObjectContentResult>;\n    createObject?(options: CreateObjectOptions): Promise<void>; // Create an object for a specified connection.\n    describeConnection?(options: DescribeConnectionOptions): Promise<DescribeConnectionResult>; // Describe a specified connection.\n    dropObject?(options: DropObjectOptions): Promise<void>; // Drop (delete) an object for a specified connection.\n    findObject?(options: FindObjectOptions): Promise<FindObjectResult>; // Find an object for a specified connection.\n    getInfo?(options: GetInfoOptions): Promise<GetInfoResult>; // Get metadata/info for a node (at any hierarchy level) for a specified connection.\n    getReadableStream?(options: GetReadableStreamOptions): Promise<ReadableStream<Uint8Array>>; // Get a reader that can retrieve all records from an object for a specified connection.\n    getRecord?(options: GetRecordOptions): Promise<GetRecordResult>; // Get a record for an object for a specified connection.\n    listNodes?(options: ListNodesOptions): Promise<ListNodesResult>; // List nodes in a folder for a specified connection.\n    previewObject?(options: PreviewObjectOptions): Promise<PreviewConfig>; // Preview an object for a specified connection.\n    removeRecords?(options: RemoveRecordsOptions): Promise<void>; // Remove one or more records from an object for a specified connection.\n    retrieveChunks?(options: RetrieveChunksOptions, chunk: (data: Uint8Array) => void, complete: () => void): Promise<void>; // Retrieve all chunks from an object for a specified connection.\n    retrieveRecords?(\n        options: RetrieveRecordsOptions,\n        chunk: (typeId: RecordRetrievalTypeId, records: Record<string, unknown>[] | ParsingRecord[]) => void,\n        complete: (result: RetrieveRecordsSummary) => void\n    ): Promise<void>; // Retrieve all records from an object for a specified connection.\n    upsertRecords?(options: UpsertRecordsOptions): Promise<void>; // Upsert one or more records into an object for a specified connection.\n}\n\nexport type ConnectorActionName = InferOutput<typeof connectorActionNameSchema>; // Names of the actions a connector may implement.\n\nexport type ConnectorConstructor = new (connectorUtilities: ConnectorUtilities, toolConfigs: ToolConfig[]) => ConnectorInterface;\n\nexport interface ConnectorUtilities {\n    hasReadableStreamTransferSupport(): boolean;\n    inferValues: (parsedRecord: ParsingRecord, columnConfigs: ObjectColumnConfig[], hasLeadingRecord: boolean) => InferenceRecord;\n    inferDataTypes: (parsedRecords: ParsingRecord[]) => InferenceSummary;\n}\n\n// ── Types - Configuration ────────────────────────────────────────────────────────────────────────────────────────────\n\nexport type ConnectorConfig = InferOutput<typeof connectorConfigSchema>;\n\ntype ConnectorCategoryConfig = InferOutput<typeof connectorCategoryConfigSchema>;\n\ntype ConnectorUsageConfig = InferOutput<typeof connectorUsageConfigSchema>;\n\n// ── Types - Action - Audit Object Content ────────────────────────────────────────────────────────────────────────────\n\nexport interface AuditObjectContentOptions1 extends EngineConnectorActionOptions {\n    chunkSize: number | undefined;\n    encodingId: string;\n    path: string;\n    valueDelimiterId: ValueDelimiterId;\n}\nexport interface AuditObjectContentResult1 {\n    contentAuditConfig: ContentAuditConfig;\n}\n\nexport interface AuditObjectContentOptions extends EngineConnectorActionOptions {\n    chunkSize: number | undefined;\n    encodingId: string;\n    parsingToolName: string | undefined;\n    path: string;\n    supportsTransferableStreams: boolean;\n    valueDelimiterId: ValueDelimiterId;\n}\nexport interface AuditObjectContentResult {\n    processedRowCount: number;\n    durationMs: number;\n}\n\n// ── Types - Action - Create Object ───────────────────────────────────────────────────────────────────────────────────\n\nexport interface CreateObjectOptions extends EngineConnectorActionOptions {\n    path: string;\n    structure: string;\n}\n\n// ── Types - Action - Describe Connection ─────────────────────────────────────────────────────────────────────────────\n\nexport type DescribeConnectionOptions = EngineConnectorActionOptions;\n\ninterface DescribeConnectionResult {\n    descriptionConfig: ConnectionDescriptionConfig;\n}\n\n// ── Types - Action - Drop Object ─────────────────────────────────────────────────────────────────────────────────────\n\nexport interface DropObjectOptions extends EngineConnectorActionOptions {\n    path: string;\n}\n\n// ── Types - Action - Find Object ─────────────────────────────────────────────────────────────────────────────────────\n\nexport interface FindObjectOptions extends EngineConnectorActionOptions {\n    storeId: string | undefined;\n    nodeId: string;\n}\nexport interface FindObjectResult {\n    path: string | undefined;\n}\n\n// ── Types - Action - Get Info ────────────────────────────────────────────────────────────────────────────────────────\n\nexport interface GetInfoOptions extends EngineConnectorActionOptions {\n    path: string;\n}\nexport interface GetInfoResult {\n    info: Record<string, unknown>; // Raw, connector-specific metadata — not yet normalized to a common shape.\n}\n\n// ── Types - Action - Get Readable Stream ─────────────────────────────────────────────────────────────────────────────\n\nexport interface GetReadableStreamOptions extends EngineConnectorActionOptions {\n    id: string;\n    path: string;\n}\n\n// ── Types - Action - Get Record ──────────────────────────────────────────────────────────────────────────────────────\n\nexport interface GetRecordOptions extends EngineConnectorActionOptions {\n    id: string;\n    path: string;\n}\nexport interface GetRecordResult {\n    record?: string[] | Record<string, unknown>;\n}\n\n// ── Types - Action - List Nodes ──────────────────────────────────────────────────────────────────────────────────────\n\nexport interface ListNodesOptions extends EngineConnectorActionOptions {\n    folderPath: string;\n    limit?: number;\n    offset?: number;\n    totalCount?: number;\n}\nexport interface ListNodesResult {\n    cursor: string | number | undefined;\n    connectionNodeConfigs: ConnectionNodeConfig[];\n    isMore: boolean;\n    totalCount: number;\n}\n\n// ── Types - Action - Preview Object ──────────────────────────────────────────────────────────────────────────────────\n\nexport interface PreviewObjectOptions extends EngineConnectorActionOptions {\n    chunkSize: number | undefined;\n    extension: string | undefined;\n    path: string;\n}\n\n// ── Types - Action - Remove Records ──────────────────────────────────────────────────────────────────────────────────\n\nexport interface RemoveRecordsOptions extends EngineConnectorActionOptions {\n    keys: string[];\n    path: string;\n}\n\n// ── Types - Action - Retrieve Chunks ─────────────────────────────────────────────────────────────────────────────────\n\nexport interface RetrieveChunksOptions extends EngineConnectorActionOptions {\n    chunkSize: number | undefined;\n    encodingId: string;\n    path: string;\n    valueDelimiterId: ValueDelimiterId;\n}\n\n// ── Types - Action - Retrieve Records ────────────────────────────────────────────────────────────────────────────────\n\nexport interface RetrieveRecordsOptions extends EngineConnectorActionOptions {\n    chunkSize: number | undefined;\n    encodingId: string;\n    path: string;\n    valueDelimiterId: ValueDelimiterId;\n}\nexport interface RetrieveRecordsSummary {\n    byteCount: number; // Number of processed bytes.\n    commentLineCount: number; // Count the number of lines being fully commented.\n    emptyLineCount: number; // Count the number of processed empty lines; work only with the skip_empty_lines option or an error will be thrown if an empty line is found.\n    lineCount: number; // Number of lines encountered in the source dataset, start at 1 for the first line.\n    nonUniformRecordCount: number; // Number of non uniform records when relax_column_count is true.\n    recordCount: number; // Count the number of processed records.\n}\n\nexport type RecordRetrievalTypeId = 'jsonRecordArray' | 'parsingRecordArray';\n\n// ── Types - Action - Upsert Records ──────────────────────────────────────────────────────────────────────────────────\n\nexport interface UpsertRecordsOptions extends EngineConnectorActionOptions {\n    records: Record<string, unknown>[];\n    path: string;\n}\n\n// ── Constants ────────────────────────────────────────────────────────────────────────────────────────────────────────\n\nconst CONNECTOR_CATEGORY_CONFIGS: { id: string; label: LocaleLabel }[] = [\n    { id: 'application', label: { en: 'Application', es: 'Aplicación' } },\n    { id: 'curatedDataset', label: { en: 'Curated Dataset', es: 'Conjunto de Datos Curado' } },\n    { id: 'database', label: { en: 'Database', es: 'Base de Datos' } },\n    { id: 'fileStore', label: { en: 'File Store', es: 'Almacén de Archivos' } }\n];\n\nexport const CONNECTOR_ACTION_NAME_MAP: Record<ConnectorActionName, string> = {\n    abortOperation: 'Abort Operation',\n    auditObjectContent: 'Audit Object Content',\n    createObject: 'Create Object',\n    describeConnection: 'Describe Connection',\n    dropObject: 'Drop Object',\n    findObject: 'Find Object',\n    getInfo: 'Get Info',\n    getReadableStream: 'Get Readable Stream',\n    getRecord: 'Get Record',\n    listNodes: 'List Nodes',\n    previewObject: 'Preview Object',\n    removeRecords: 'Remove Records',\n    retrieveChunks: 'Retrieve Chunks',\n    retrieveRecords: 'Retrieve Records',\n    upsertRecords: 'Upsert Records'\n};\n\nconst CONNECTOR_USAGE_CONFIGS: { id: string; label: LocaleLabel }[] = [\n    { id: 'bidirectional', label: { en: 'Bidirectional', es: 'Bidireccional' } },\n    { id: 'destination', label: { en: 'Destination', es: 'Destino' } },\n    { id: 'source', label: { en: 'Source', es: 'Origen' } },\n    { id: 'unknown', label: { en: 'Unknown', es: 'Desconocido' } }\n];\n\nconst CONNECTOR_DESTINATION_OPERATIONS = new Set<ConnectorActionName>(['createObject', 'dropObject', 'removeRecords', 'upsertRecords']);\nconst CONNECTOR_SOURCE_OPERATIONS = new Set<ConnectorActionName>([\n    'auditObjectContent',\n    'findObject',\n    'getInfo',\n    'getReadableStream',\n    'getRecord',\n    'listNodes',\n    'previewObject',\n    'retrieveChunks',\n    'retrieveRecords'\n]);\n\n// ── Types - Usage ────────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport type ConnectorUsageId = InferOutput<typeof connectorUsageIdSchema>;\n\n// ── Actions ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Determines whether a connector is a source, destination, or bidirectional connector, based on the actions it implements.\nexport function determineConnectorUsageId(actionNames: ConnectorActionName[]): ConnectorUsageId {\n    let isSourceOperation = false;\n    let isDestinationOperation = false;\n    for (const actionName of actionNames) {\n        if (CONNECTOR_SOURCE_OPERATIONS.has(actionName)) isSourceOperation = true;\n        if (CONNECTOR_DESTINATION_OPERATIONS.has(actionName)) isDestinationOperation = true;\n    }\n    if (isSourceOperation && isDestinationOperation) return 'bidirectional';\n    if (isSourceOperation) return 'source';\n    return isDestinationOperation ? 'destination' : 'source';\n}\n\nexport const constructConnectorCategoryConfig = (id: string, localeId = DEFAULT_LOCALE_ID): LocalisedConfig<ConnectorCategoryConfig> => {\n    const connectorCategory = CONNECTOR_CATEGORY_CONFIGS.find((connectorCategory) => connectorCategory.id === id);\n    if (connectorCategory) {\n        const labelMap = createLabelMap(connectorCategory.label);\n        const localizedLabel = resolveLabel(labelMap, localeId);\n        return { label: localizedLabel ?? connectorCategory.id, description: '' };\n    }\n    return { label: id, description: '' };\n};\n\nexport const constructConnectorUsageConfig = (id: string, localeId = DEFAULT_LOCALE_ID): LocalisedConfig<ConnectorUsageConfig> => {\n    const connectorUsage = CONNECTOR_USAGE_CONFIGS.find((connectorUsage) => connectorUsage.id === id);\n    if (connectorUsage) {\n        const labelMap = createLabelMap(connectorUsage.label);\n        const localizedLabel = resolveLabel(labelMap, localeId);\n        return { label: localizedLabel ?? connectorUsage.id, description: '' };\n    }\n    return { label: id, description: '' };\n};\n\nexport function getConnectorActionsTable(supported: ConnectorActionName[]): string {\n    const supportedSet = new Set(supported);\n    let md = '|Action|Supported|\\n';\n    md += '|:----|:-------:|\\n';\n    for (const id of Object.keys(CONNECTOR_ACTION_NAME_MAP) as ConnectorActionName[]) {\n        md += `| ${CONNECTOR_ACTION_NAME_MAP[id]} | ${supportedSet.has(id) ? '✓' : ''} |\\n`;\n    }\n    return md;\n}\n"],"mappings":";;;;AAgBA,IAAa,IAA4B,EAAa;CAClD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ,CAAC,GAIK,IAA4B,EAAa;CAAC;CAAe;CAAkB;CAAY;AAAW,CAAC,GAE5F,IAAgC,EAAa,EACtD,OAAO,EACX,CAAC,GAIY,IAAyB,EAAa;CAAC;CAAiB;CAAe;AAAQ,CAAC,GAEhF,IAA6B,EAAa,EACnD,OAAO,EACX,CAAC,GAIK,IAA8B,EAAa;CAAC;CAAU;CAAY;CAAU;AAAM,CAAC,GAEnF,IAA0C,EAAO,EAAO,GAAG,EAAO,CAAC,GAGnE,IAAgC,EAAa;CAC/C,cAAc;CACd,uBAAuB,EAAS,EAAO,CAAC;CACxC,aAAa,EAAS,EAAQ,CAAC;CAC/B,IAAI,EAAS,EAAO,CAAC;CACrB,OAAO,EAAS,CAAiB;CACjC,oBAAoB,EAAS,EAAO,CAAC;CACrC,QAAQ,EAAS,EAAM,CAAuC,CAAC;AACnE,CAAC,GAIY,IAAwB,EAAa;CAC9C,GAAG;CACH,QAAQ,EAAQ,WAAW;CAC3B,aAAa,EAAM,CAAyB;CAC5C,UAAU,EAAS,CAA6B;CAChD,YAAY;CACZ,iBAAiB,EAAO,EAAO,GAAG,CAA6B;CAC/D,OAAO,EAAS,CAA0B;CAC1C,SAAS,EAAS,CAAsB;AAC5C,CAAC,GC2IK,IAAmE;CACrE;EAAE,IAAI;EAAe,OAAO;GAAE,IAAI;GAAe,IAAI;EAAa;CAAE;CACpE;EAAE,IAAI;EAAkB,OAAO;GAAE,IAAI;GAAmB,IAAI;EAA2B;CAAE;CACzF;EAAE,IAAI;EAAY,OAAO;GAAE,IAAI;GAAY,IAAI;EAAgB;CAAE;CACjE;EAAE,IAAI;EAAa,OAAO;GAAE,IAAI;GAAc,IAAI;EAAsB;CAAE;AAC9E,GAEa,IAAiE;CAC1E,gBAAgB;CAChB,oBAAoB;CACpB,cAAc;CACd,oBAAoB;CACpB,YAAY;CACZ,YAAY;CACZ,SAAS;CACT,mBAAmB;CACnB,WAAW;CACX,WAAW;CACX,eAAe;CACf,eAAe;CACf,gBAAgB;CAChB,iBAAiB;CACjB,eAAe;AACnB,GAEM,IAAgE;CAClE;EAAE,IAAI;EAAiB,OAAO;GAAE,IAAI;GAAiB,IAAI;EAAgB;CAAE;CAC3E;EAAE,IAAI;EAAe,OAAO;GAAE,IAAI;GAAe,IAAI;EAAU;CAAE;CACjE;EAAE,IAAI;EAAU,OAAO;GAAE,IAAI;GAAU,IAAI;EAAS;CAAE;CACtD;EAAE,IAAI;EAAW,OAAO;GAAE,IAAI;GAAW,IAAI;EAAc;CAAE;AACjE,GAEM,oBAAmC,IAAI,IAAyB;CAAC;CAAgB;CAAc;CAAiB;AAAe,CAAC,GAChI,oBAA8B,IAAI,IAAyB;CAC7D;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ,CAAC;AASD,SAAgB,EAA0B,GAAsD;CAC5F,IAAI,IAAoB,IACpB,IAAyB;CAC7B,KAAK,IAAM,KAAc,GAErB,AADI,EAA4B,IAAI,CAAU,MAAG,IAAoB,KACjE,EAAiC,IAAI,CAAU,MAAG,IAAyB;CAInF,OAFI,KAAqB,IAA+B,kBACpD,IAA0B,WACvB,IAAyB,gBAAgB;AACpD;AAEA,IAAa,KAAoC,GAAY,IAAA,SAA2E;CACpI,IAAM,IAAoB,EAA2B,MAAM,MAAsB,EAAkB,OAAO,CAAE;CAC5G,IAAI,GAAmB;EACnB,IAAM,IAAW,EAAe,EAAkB,KAAK;EAEvD,OAAO;GAAE,OADc,EAAa,GAAU,CAC9B,KAAkB,EAAkB;GAAI,aAAa;EAAG;CAC5E;CACA,OAAO;EAAE,OAAO;EAAI,aAAa;CAAG;AACxC,GAEa,KAAiC,GAAY,IAAA,SAAwE;CAC9H,IAAM,IAAiB,EAAwB,MAAM,MAAmB,EAAe,OAAO,CAAE;CAChG,IAAI,GAAgB;EAChB,IAAM,IAAW,EAAe,EAAe,KAAK;EAEpD,OAAO;GAAE,OADc,EAAa,GAAU,CAC9B,KAAkB,EAAe;GAAI,aAAa;EAAG;CACzE;CACA,OAAO;EAAE,OAAO;EAAI,aAAa;CAAG;AACxC;AAEA,SAAgB,EAAyB,GAA0C;CAC/E,IAAM,IAAe,IAAI,IAAI,CAAS,GAClC,IAAK;CACT,KAAM;CACN,KAAK,IAAM,KAAM,OAAO,KAAK,CAAyB,GAClD,KAAM,KAAK,EAA0B,GAAI,KAAK,EAAa,IAAI,CAAE,IAAI,MAAM,GAAG;CAElF,OAAO;AACX"}
+{"version":3,"file":"dpuse-shared-componentModuleConnector.es.js","names":[],"sources":["../src/component/module/connector/connectorConfig.schema.ts","../src/component/module/connector/index.ts"],"sourcesContent":["/**\n * Defines the configuration metadata for a connector. Used for validation\n * of connector manifests and capability discovery at runtime.\n */\n\n// ── External Dependencies & Registrations\nimport { array, boolean, literal, nullable, number, optional, record, strictObject, string } from 'valibot';\n\n// ── DPUse Framework\nimport { literalUnion } from '@/schema';\nimport { localeLabelSchema } from '@/locale/locale.schema';\nimport { moduleConfigCoreFields } from '@/component/module/moduleConfig.schema';\n\n// ── Schemas - Action Name ────────────────────────────────────────────────────────────────────────────────────────────\n\n// Names of the operations a connector may implement.\nexport const connectorActionNameSchema = literalUnion([\n    'abortOperation',\n    'auditObjectContent',\n    'createObject',\n    'describeConnection',\n    'dropObject',\n    'findObject',\n    'getInfo',\n    'getReadableStream',\n    'getRecord',\n    'listNodes',\n    'previewObject',\n    'removeRecords',\n    'retrieveChunks',\n    'retrieveRecords',\n    'upsertRecords'\n]);\n\n// ── Schemas - Category Configuration ─────────────────────────────────────────────────────────────────────────────────\n\nconst connectorCategoryIdSchema = literalUnion(['application', 'curatedDataset', 'database', 'fileStore']); // Category identifiers used for grouping and filtering connectors.\n\nexport const connectorCategoryConfigSchema = strictObject({\n    label: localeLabelSchema\n});\n\n// ── Schemas - Usage ──────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport const connectorUsageIdSchema = literalUnion(['bidirectional', 'destination', 'source', 'unknown']); // Connector data pipeline usage identifiers.\n\nexport const connectorUsageConfigSchema = strictObject({\n    label: localeLabelSchema\n});\n\n// ── Schemas - Implementation ─────────────────────────────────────────────────────────────────────────────────────────\n\nconst connectorAuthMethodIdSchema = literalUnion(['apiKey', 'disabled', 'oAuth2', 'none']); // Authentication method identifiers supported by a connector implementation.\n\nconst connectorImplementationParametersSchema = record(string(), string()); // One set of implementation parameters, keyed by name.\n\n// A connector implementation variant. A single connector may expose multiple implementations differing by auth method, limits, or vendor-specific behavior.\nconst connectorImplementationSchema = strictObject({\n    authMethodId: connectorAuthMethodIdSchema,\n    activeConnectionCount: optional(number()),\n    canDescribe: optional(boolean()),\n    id: optional(string()),\n    label: optional(localeLabelSchema),\n    maxConnectionCount: nullable(number()),\n    params: optional(array(connectorImplementationParametersSchema))\n});\n\n// ── Schemas - Configuration ──────────────────────────────────────────────────────────────────────────────────────────\n\nexport const connectorConfigSchema = strictObject({\n    ...moduleConfigCoreFields,\n    typeId: literal('connector'),\n    actionNames: array(connectorActionNameSchema),\n    category: nullable(connectorCategoryConfigSchema),\n    categoryId: connectorCategoryIdSchema,\n    implementations: record(string(), connectorImplementationSchema),\n    usage: nullable(connectorUsageConfigSchema),\n    usageId: nullable(connectorUsageIdSchema)\n});\n","// ── External Dependencies & Registrations\nimport type { InferOutput } from 'valibot';\n\n// ── DPUse Framework\nimport type { Component } from '@/component';\nimport type { EngineConnectorActionOptions } from '@/component/module/engine';\nimport type { ToolConfig } from '@/component/module/tool';\nimport type { ConnectionDescriptionConfig, ConnectionNodeConfig, ObjectColumnConfig } from '@/component/connection';\nimport type {\n    connectorActionNameSchema,\n    connectorCategoryConfigSchema,\n    connectorConfigSchema,\n    connectorUsageConfigSchema,\n    connectorUsageIdSchema\n} from '@/component/module/connector/connectorConfig.schema';\nimport type { ContentAuditConfig, InferenceRecord, InferenceSummary, ParsingRecord, PreviewConfig, ValueDelimiterId } from '@/component/dataView';\nimport { createLabelMap, DEFAULT_LOCALE_ID, type LocaleLabel, resolveLabel } from '@/locale/label';\nimport type { LocalisedConfig } from '@/locale';\n\n// ── Schemas ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport { connectorConfigSchema } from '@/component/module/connector/connectorConfig.schema';\n\n// ── Types - Interface ────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport interface ConnectorInterface extends Component {\n    abortController: AbortController | undefined;\n    readonly config: ConnectorConfig;\n    readonly toolConfigs: ToolConfig[];\n    abortOperation?(): void; // Abort the active long running action.\n    auditObjectContent?(options: AuditObjectContentOptions, chunk: (rowCount: number) => void): Promise<AuditObjectContentResult>;\n    createObject?(options: CreateObjectOptions): Promise<void>; // Create an object for a specified connection.\n    describeConnection?(options: DescribeConnectionOptions): Promise<DescribeConnectionResult>; // Describe a specified connection.\n    dropObject?(options: DropObjectOptions): Promise<void>; // Drop (delete) an object for a specified connection.\n    findObject?(options: FindObjectOptions): Promise<FindObjectResult>; // Find an object for a specified connection.\n    getInfo?(options: GetInfoOptions): Promise<GetInfoResult>; // Get metadata/info for a node (at any hierarchy level) for a specified connection.\n    getReadableStream?(options: GetReadableStreamOptions): Promise<ReadableStream<Uint8Array>>; // Get a reader that can retrieve all records from an object for a specified connection.\n    getRecord?(options: GetRecordOptions): Promise<GetRecordResult>; // Get a record for an object for a specified connection.\n    listNodes?(options: ListNodesOptions): Promise<ListNodesResult>; // List nodes in a folder for a specified connection.\n    previewObject?(options: PreviewObjectOptions): Promise<PreviewConfig>; // Preview an object for a specified connection.\n    removeRecords?(options: RemoveRecordsOptions): Promise<void>; // Remove one or more records from an object for a specified connection.\n    retrieveChunks?(options: RetrieveChunksOptions, chunk: (data: Uint8Array) => void, complete: () => void): Promise<void>; // Retrieve all chunks from an object for a specified connection.\n    retrieveRecords?(\n        options: RetrieveRecordsOptions,\n        chunk: (typeId: RecordRetrievalTypeId, records: Record<string, unknown>[] | ParsingRecord[]) => void,\n        complete: (result: RetrieveRecordsSummary) => void\n    ): Promise<void>; // Retrieve all records from an object for a specified connection.\n    upsertRecords?(options: UpsertRecordsOptions): Promise<void>; // Upsert one or more records into an object for a specified connection.\n}\n\nexport type ConnectorActionName = InferOutput<typeof connectorActionNameSchema>; // Names of the actions a connector may implement.\n\nexport type ConnectorConstructor = new (connectorUtilities: ConnectorUtilities, toolConfigs: ToolConfig[]) => ConnectorInterface;\n\nexport interface ConnectorUtilities {\n    hasReadableStreamTransferSupport(): boolean;\n    inferValues: (parsedRecord: ParsingRecord, columnConfigs: ObjectColumnConfig[], hasLeadingRecord: boolean) => InferenceRecord;\n    inferDataTypes: (parsedRecords: ParsingRecord[]) => InferenceSummary;\n}\n\n// ── Types - Configuration ────────────────────────────────────────────────────────────────────────────────────────────\n\nexport type ConnectorConfig = InferOutput<typeof connectorConfigSchema>;\n\ntype ConnectorCategoryConfig = InferOutput<typeof connectorCategoryConfigSchema>;\n\ntype ConnectorUsageConfig = InferOutput<typeof connectorUsageConfigSchema>;\n\n// ── Types - Action - Audit Object Content ────────────────────────────────────────────────────────────────────────────\n\nexport interface AuditObjectContentOptions1 extends EngineConnectorActionOptions {\n    chunkSize: number | undefined;\n    encodingId: string;\n    path: string;\n    valueDelimiterId: ValueDelimiterId;\n}\nexport interface AuditObjectContentResult1 {\n    contentAuditConfig: ContentAuditConfig;\n}\n\nexport interface AuditObjectContentOptions extends EngineConnectorActionOptions {\n    chunkSize: number | undefined;\n    encodingId: string;\n    parsingToolName: string | undefined;\n    path: string;\n    supportsTransferableStreams: boolean;\n    valueDelimiterId: ValueDelimiterId;\n}\nexport interface AuditObjectContentResult {\n    processedRowCount: number;\n    durationMs: number;\n}\n\n// ── Types - Action - Create Object ───────────────────────────────────────────────────────────────────────────────────\n\nexport interface CreateObjectOptions extends EngineConnectorActionOptions {\n    path: string;\n    structure: string;\n}\n\n// ── Types - Action - Describe Connection ─────────────────────────────────────────────────────────────────────────────\n\nexport type DescribeConnectionOptions = EngineConnectorActionOptions;\n\ninterface DescribeConnectionResult {\n    descriptionConfig: ConnectionDescriptionConfig;\n}\n\n// ── Types - Action - Drop Object ─────────────────────────────────────────────────────────────────────────────────────\n\nexport interface DropObjectOptions extends EngineConnectorActionOptions {\n    path: string;\n}\n\n// ── Types - Action - Find Object ─────────────────────────────────────────────────────────────────────────────────────\n\nexport interface FindObjectOptions extends EngineConnectorActionOptions {\n    storeId: string | undefined;\n    nodeId: string;\n}\nexport interface FindObjectResult {\n    path: string | undefined;\n}\n\n// ── Types - Action - Get Info ────────────────────────────────────────────────────────────────────────────────────────\n\nexport interface GetInfoOptions extends EngineConnectorActionOptions {\n    path: string;\n}\nexport interface GetInfoResult {\n    info: Record<string, unknown>; // Raw, connector-specific metadata — not yet normalized to a common shape.\n}\n\n// ── Types - Action - Get Readable Stream ─────────────────────────────────────────────────────────────────────────────\n\nexport interface GetReadableStreamOptions extends EngineConnectorActionOptions {\n    id: string;\n    path: string;\n}\n\n// ── Types - Action - Get Record ──────────────────────────────────────────────────────────────────────────────────────\n\nexport interface GetRecordOptions extends EngineConnectorActionOptions {\n    id: string;\n    path: string;\n}\nexport interface GetRecordResult {\n    record?: string[] | Record<string, unknown>;\n}\n\n// ── Types - Action - List Nodes ──────────────────────────────────────────────────────────────────────────────────────\n\nexport interface ListNodesOptions extends EngineConnectorActionOptions {\n    folderPath: string;\n    limit?: number;\n    offset?: number;\n    totalCount?: number;\n}\nexport interface ListNodesResult {\n    cursor: string | number | undefined;\n    connectionNodeConfigs: ConnectionNodeConfig[];\n    isMore: boolean;\n    totalCount: number;\n}\n\n// ── Types - Action - Preview Object ──────────────────────────────────────────────────────────────────────────────────\n\nexport interface PreviewObjectOptions extends EngineConnectorActionOptions {\n    chunkSize: number | undefined;\n    extension: string | undefined;\n    path: string;\n}\n\n// ── Types - Action - Remove Records ──────────────────────────────────────────────────────────────────────────────────\n\nexport interface RemoveRecordsOptions extends EngineConnectorActionOptions {\n    keys: string[];\n    path: string;\n}\n\n// ── Types - Action - Retrieve Chunks ─────────────────────────────────────────────────────────────────────────────────\n\nexport interface RetrieveChunksOptions extends EngineConnectorActionOptions {\n    chunkSize: number | undefined;\n    encodingId: string;\n    path: string;\n    valueDelimiterId: ValueDelimiterId;\n}\n\n// ── Types - Action - Retrieve Records ────────────────────────────────────────────────────────────────────────────────\n\nexport interface RetrieveRecordsOptions extends EngineConnectorActionOptions {\n    chunkSize: number | undefined;\n    encodingId: string;\n    path: string;\n    valueDelimiterId: ValueDelimiterId;\n}\nexport interface RetrieveRecordsSummary {\n    byteCount: number; // Number of processed bytes.\n    commentLineCount: number; // Count the number of lines being fully commented.\n    emptyLineCount: number; // Count the number of processed empty lines; work only with the skip_empty_lines option or an error will be thrown if an empty line is found.\n    lineCount: number; // Number of lines encountered in the source dataset, start at 1 for the first line.\n    nonUniformRecordCount: number; // Number of non uniform records when relax_column_count is true.\n    recordCount: number; // Count the number of processed records.\n}\n\nexport type RecordRetrievalTypeId = 'jsonRecordArray' | 'parsingRecordArray';\n\n// ── Types - Action - Upsert Records ──────────────────────────────────────────────────────────────────────────────────\n\nexport interface UpsertRecordsOptions extends EngineConnectorActionOptions {\n    records: Record<string, unknown>[];\n    path: string;\n}\n\n// ── Constants ────────────────────────────────────────────────────────────────────────────────────────────────────────\n\nconst CONNECTOR_CATEGORY_CONFIGS: { id: string; label: LocaleLabel }[] = [\n    { id: 'application', label: { en: 'Application', es: 'Aplicación' } },\n    { id: 'curatedDataset', label: { en: 'Curated Dataset', es: 'Conjunto de Datos Curado' } },\n    { id: 'database', label: { en: 'Database', es: 'Base de Datos' } },\n    { id: 'fileStore', label: { en: 'File Store', es: 'Almacén de Archivos' } }\n];\n\nexport const CONNECTOR_ACTION_NAME_MAP: Record<ConnectorActionName, string> = {\n    abortOperation: 'Abort Operation',\n    auditObjectContent: 'Audit Object Content',\n    createObject: 'Create Object',\n    describeConnection: 'Describe Connection',\n    dropObject: 'Drop Object',\n    findObject: 'Find Object',\n    getInfo: 'Get Info',\n    getReadableStream: 'Get Readable Stream',\n    getRecord: 'Get Record',\n    listNodes: 'List Nodes',\n    previewObject: 'Preview Object',\n    removeRecords: 'Remove Records',\n    retrieveChunks: 'Retrieve Chunks',\n    retrieveRecords: 'Retrieve Records',\n    upsertRecords: 'Upsert Records'\n};\n\nconst CONNECTOR_USAGE_CONFIGS: { id: string; label: LocaleLabel }[] = [\n    { id: 'bidirectional', label: { en: 'Bidirectional', es: 'Bidireccional' } },\n    { id: 'destination', label: { en: 'Destination', es: 'Destino' } },\n    { id: 'source', label: { en: 'Source', es: 'Origen' } },\n    { id: 'unknown', label: { en: 'Unknown', es: 'Desconocido' } }\n];\n\nconst CONNECTOR_DESTINATION_OPERATIONS = new Set<ConnectorActionName>(['createObject', 'dropObject', 'removeRecords', 'upsertRecords']);\nconst CONNECTOR_SOURCE_OPERATIONS = new Set<ConnectorActionName>([\n    'auditObjectContent',\n    'findObject',\n    'getInfo',\n    'getReadableStream',\n    'getRecord',\n    'listNodes',\n    'previewObject',\n    'retrieveChunks',\n    'retrieveRecords'\n]);\n\n// ── Types - Usage ────────────────────────────────────────────────────────────────────────────────────────────────────\n\nexport type ConnectorUsageId = InferOutput<typeof connectorUsageIdSchema>;\n\n// ── Actions ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Determines whether a connector is a source, destination, or bidirectional connector, based on the actions it implements.\nexport function determineConnectorUsageId(actionNames: ConnectorActionName[]): ConnectorUsageId {\n    let isSourceOperation = false;\n    let isDestinationOperation = false;\n    for (const actionName of actionNames) {\n        if (CONNECTOR_SOURCE_OPERATIONS.has(actionName)) isSourceOperation = true;\n        if (CONNECTOR_DESTINATION_OPERATIONS.has(actionName)) isDestinationOperation = true;\n    }\n    if (isSourceOperation && isDestinationOperation) return 'bidirectional';\n    if (isSourceOperation) return 'source';\n    return isDestinationOperation ? 'destination' : 'unknown'; // Neither reads nor writes data, e.g. only 'abortOperation' or 'describeConnection'.\n}\n\nexport const constructConnectorCategoryConfig = (id: string, localeId = DEFAULT_LOCALE_ID): LocalisedConfig<ConnectorCategoryConfig> => {\n    const connectorCategory = CONNECTOR_CATEGORY_CONFIGS.find((connectorCategory) => connectorCategory.id === id);\n    if (connectorCategory) {\n        const labelMap = createLabelMap(connectorCategory.label);\n        const localizedLabel = resolveLabel(labelMap, localeId);\n        return { label: localizedLabel ?? connectorCategory.id, description: '' };\n    }\n    return { label: id, description: '' };\n};\n\nexport const constructConnectorUsageConfig = (id: string, localeId = DEFAULT_LOCALE_ID): LocalisedConfig<ConnectorUsageConfig> => {\n    const connectorUsage = CONNECTOR_USAGE_CONFIGS.find((connectorUsage) => connectorUsage.id === id);\n    if (connectorUsage) {\n        const labelMap = createLabelMap(connectorUsage.label);\n        const localizedLabel = resolveLabel(labelMap, localeId);\n        return { label: localizedLabel ?? connectorUsage.id, description: '' };\n    }\n    return { label: id, description: '' };\n};\n\nexport function getConnectorActionsTable(supported: ConnectorActionName[]): string {\n    const supportedSet = new Set(supported);\n    let md = '|Action|Supported|\\n';\n    md += '|:----|:-------:|\\n';\n    for (const id of Object.keys(CONNECTOR_ACTION_NAME_MAP) as ConnectorActionName[]) {\n        md += `| ${CONNECTOR_ACTION_NAME_MAP[id]} | ${supportedSet.has(id) ? '✓' : ''} |\\n`;\n    }\n    return md;\n}\n"],"mappings":"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"}

package/dist/dpuse-shared-errors.es.js

@@ -1,49 +1,55 @@
 //#region src/errors/index.ts
-var e = 2048, t = class extends Error {
+var e = 2048, t = "[REDACTED]", n = /api[-_]?key|authori[sz]ation|cookie|credential|passw(?:or)?d|private[-_]?key|secret|token/i, r = [
+	[/\b(Bearer|Basic) +[\w.~+/=-]+/gi, (e, n) => `${n} ${t}`],
+	[/(?<![\w-])([\w-]+)(["']?[ \t]*[:=][ \t]*["']?)([^\s"'&,;}?#]+)/g, (e, r, i, a) => n.test(r) && !/^(?:Basic|Bearer)$/i.test(a) ? `${r}${i}${t}` : e],
+	[/\beyJ[\w-]+\.[\w-]+\.[\w-]*/g, () => t],
+	[/\b(?:sk-|xaat-|xapt-|sl\.)[\w-]{16,}/g, () => t],
+	[/(?<![\w.+-])[\w.+-]+@[\w-]+\.[\w.-]+/g, () => t]
+], i = class extends Error {
 	data;
 	locator;
 	constructor(e, t, n, r) {
 		super(e, r), this.name = "DPUseError", this.data = n, this.locator = t;
 	}
-}, n = class extends t {
+}, a = class extends i {
 	constructor(e, t, n, r) {
 		super(e, t, n, r), this.name = "AppError";
 	}
-}, r = class extends t {
+}, o = class extends i {
 	constructor(e, t, n, r) {
 		super(e, t, n, r), this.name = "APIError";
 	}
-}, i = class extends t {
+}, s = class extends i {
 	constructor(e, t, n, r) {
 		super(e, t, n, r), this.name = "EngineError";
 	}
-}, a = class extends t {
+}, c = class extends i {
 	constructor(e, t, n, r) {
 		super(e, t, n, r), this.name = "ConnectorError";
 	}
-}, o = class extends t {
+}, l = class extends i {
 	constructor(e, t, n, r) {
 		super(e, t, n, r), this.name = "FetchError";
 	}
 };
-async function s(e, t, n) {
+async function u(e, t, n) {
 	let r = ` - ${e.statusText}`, i = `${t} Response status '${String(e.status)}${e.statusText ? r : ""}' received.`, a;
 	try {
 		a = await e.text();
 	} catch (e) {
-		a = `<body unavailable: ${u(e).message}>`;
+		a = `<body unavailable: ${p(e).message}>`;
 	}
-	return new o(i, n, { body: h(a) });
+	return new l(i, n, { body: x(a) });
 }
-function c(e) {
+function d(e) {
 	return e.map((e) => e.message).join(" ");
 }
-function l(e) {
+function f(e) {
 	try {
 		e();
 	} catch {}
 }
-function u(e) {
+function p(e) {
 	if (e instanceof Error) return e;
 	if (typeof e == "string") return Error(e);
 	if (typeof e == "number" || typeof e == "boolean" || typeof e == "bigint") return Error(String(e));
@@ -55,24 +61,24 @@ function u(e) {
 	}
 	return /* @__PURE__ */ Error("Unknown error");
 }
-function d(e) {
-	let t = /* @__PURE__ */ new Set(), n = [], r = u(e);
+function m(e) {
+	let t = /* @__PURE__ */ new Set(), n = [], r = p(e);
 	for (; r != null && !t.has(r);) {
 		t.add(r);
-		let [e, i] = g(r);
-		/(?:\.{3}|[.!?])$/.test(e.message) || (e.message += "."), n.push(e), r = i;
+		let [e, i] = S(r);
+		/(?:\.{3}|[.!?])$/.test(e.message) || (e.message += "."), n.push(v(e)), r = i;
 	}
 	return n;
 }
-function f(e) {
+function h(e) {
 	let t;
 	for (let n of e.toReversed()) {
-		let e = m(n, t);
+		let e = _(n, t);
 		n.stack !== void 0 && (e.stack = n.stack), t = e;
 	}
 	return t ?? /* @__PURE__ */ Error("No error to unserialise.");
 }
-function p(e) {
+function g(e) {
 	let t;
 	try {
 		t = JSON.stringify(e);
@@ -81,13 +87,13 @@ function p(e) {
 	}
 	return t === "" && (t = "Unknown error"), t;
 }
-function m(e, t) {
+function _(e, t) {
 	switch (e.name) {
-		case "APIError": return new r(e.message, e.locator, e.data, { cause: t });
-		case "AppError": return new n(e.message, e.locator, e.data, { cause: t });
-		case "ConnectorError": return new a(e.message, e.locator, e.data, { cause: t });
-		case "EngineError": return new i(e.message, e.locator, e.data, { cause: t });
-		case "FetchError": return new o(e.message, e.locator, e.data, { cause: t });
+		case "APIError": return new o(e.message, e.locator, e.data, { cause: t });
+		case "AppError": return new a(e.message, e.locator, e.data, { cause: t });
+		case "ConnectorError": return new c(e.message, e.locator, e.data, { cause: t });
+		case "EngineError": return new s(e.message, e.locator, e.data, { cause: t });
+		case "FetchError": return new l(e.message, e.locator, e.data, { cause: t });
 		default: {
 			let n = e.name;
 			return new class extends Error {
@@ -96,32 +102,49 @@ function m(e, t) {
 		}
 	}
 }
-function h(t) {
+function v(e) {
+	let { data: t, message: n, stack: r } = e;
+	return {
+		...e,
+		data: t === void 0 ? void 0 : b(t, /* @__PURE__ */ new WeakSet(), 0),
+		message: y(n),
+		stack: r === void 0 ? void 0 : y(r)
+	};
+}
+function y(e) {
+	let t = e;
+	for (let [e, n] of r) t = t.replaceAll(e, (e, ...t) => n(e, ...t));
+	return t;
+}
+function b(e, r, i) {
+	return typeof e == "string" ? y(e) : typeof e != "object" || !e ? e : i >= 10 ? t : r.has(e) ? "[Circular]" : (r.add(e), Array.isArray(e) ? e.map((e) => b(e, r, i + 1)) : Object.fromEntries(Object.entries(e).map(([e, a]) => [e, a != null && n.test(e) ? t : b(a, r, i + 1)])));
+}
+function x(t) {
 	if (t != null && t !== "") return t.length > e ? `${t.slice(0, e)}... [truncated]` : t;
 }
-function g(e) {
-	let n = e.cause == null ? null : u(e.cause);
-	if (e instanceof t) return [{
+function S(e) {
+	let t = e.cause == null ? null : p(e.cause);
+	if (e instanceof i) return [{
 		data: e.data,
 		locator: e.locator,
 		message: e.message,
 		name: e.name,
 		stack: e.stack
-	}, n];
-	let r = Object.fromEntries(Object.entries(e).filter(([e]) => e !== "cause"));
+	}, t];
+	let n = Object.fromEntries(Object.entries(e).filter(([e]) => e !== "cause"));
 	return e.name ? [{
-		data: r,
+		data: n,
 		locator: "",
 		message: e.message,
 		name: e.name,
 		stack: e.stack
-	}, n] : [{
-		data: r,
+	}, t] : [{
+		data: n,
 		locator: "",
-		message: p(e),
+		message: g(e),
 		name: "Error",
 		stack: void 0
 	}, null];
 }
 //#endregion
-export { r as APIError, n as AppError, a as ConnectorError, t as DPUseError, i as EngineError, o as FetchError, s as buildFetchError, c as concatenateSerialisedErrorMessages, l as ignoreErrors, u as normalizeToError, d as serialiseError, f as unserialiseError };
+export { o as APIError, a as AppError, c as ConnectorError, i as DPUseError, s as EngineError, l as FetchError, u as buildFetchError, d as concatenateSerialisedErrorMessages, f as ignoreErrors, p as normalizeToError, m as serialiseError, h as unserialiseError };

package/dist/dpuse-shared-errors.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"dpuse-shared-errors.es.js","names":[],"sources":["../src/errors/index.ts"],"sourcesContent":["// ── Types ────────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Serializable representation of an error; used for transporting errors across api and worker boundaries\nexport interface SerialisedError {\n    data: Record<string, unknown> | undefined;\n    locator: string; // Error locator 'package.module.method'\n    message: string; // Human-readable error message\n    name: string; // Error class or type name\n    stack: string | undefined; // Stack trace if available\n}\n\n// ── Constants  ───────────────────────────────────────────────────────────────────────────────────────────────────────\n\nconst RESPONSE_ERROR_BODY_LIMIT = 2048;\n\n// ── Errors ───────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Base class for all DPUse  errors; includes a locator for the error; never thrown directly\nexport class DPUseError extends Error {\n    readonly data: Record<string, unknown> | undefined;\n    readonly locator: string; // Error locator 'package.module.method'\n    constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n        super(message, options);\n        this.name = 'DPUseError';\n        this.data = data;\n        this.locator = locator;\n    }\n}\n\n// Thrown when an app (studio/assistant) error occurs\nexport class AppError extends DPUseError {\n    constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n        super(message, locator, data, options);\n        this.name = 'AppError';\n    }\n}\n\n// Thrown when an API request fails\nexport class APIError extends DPUseError {\n    constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n        super(message, locator, data, options);\n        this.name = 'APIError';\n    }\n}\n\n// Thrown when an engine request fails\nexport class EngineError extends DPUseError {\n    constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n        super(message, locator, data, options);\n        this.name = 'EngineError';\n    }\n}\n\n// Thrown when an connector operation fails; will always be wrapped in an engine error\nexport class ConnectorError extends DPUseError {\n    constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n        super(message, locator, data, options);\n        this.name = 'ConnectorError';\n    }\n}\n\n// Thrown when an HTTP request fails; may include a sanitized portion of the response body for diagnostic purposes\nexport class FetchError extends DPUseError {\n    constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n        super(message, locator, data, options);\n        this.name = 'FetchError';\n    }\n}\n\n// ── Actions ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Builds a fetch error from an HTTP response; includes a text copy of the response body\nexport async function buildFetchError(response: { status: number; statusText: string; text: () => Promise<string> }, message: string, locator: string): Promise<FetchError> {\n    const responseStatusStuff = ` - ${response.statusText}`;\n    const fetchMessage = `${message} Response status '${String(response.status)}${response.statusText ? responseStatusStuff : ''}' received.`;\n    let bodyText: string;\n    try {\n        bodyText = await response.text();\n    } catch (error) {\n        const normalised = normalizeToError(error);\n        bodyText = `<body unavailable: ${normalised.message}>`;\n    }\n    return new FetchError(fetchMessage, locator, { body: sanitizeResponseErrorBody(bodyText) });\n}\n\n// Concatenates serialized error messages into a single string\nexport function concatenateSerialisedErrorMessages(serialisedErrors: SerialisedError[]): string {\n    return serialisedErrors.map((serialisedError) => serialisedError.message).join(' ');\n}\n\n// Ignore best-effort cleanup errors to keep teardown noise-free\nexport function ignoreErrors(action: () => void): void {\n    try {\n        action();\n    } catch {\n        // Intentionally ignore errors\n    }\n}\n\n// Normalizes an unknown thrown value into an error\nexport function normalizeToError(value: unknown): Error {\n    if (value instanceof Error) return value;\n    if (typeof value === 'string') return new Error(value);\n    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') return new Error(String(value));\n    if (typeof value === 'symbol') return new Error(value.description ?? 'Unknown error');\n    if (typeof value === 'object') {\n        try {\n            return new Error(JSON.stringify(value));\n        } catch {\n            return new Error('Unknown error');\n        }\n    }\n    return new Error('Unknown error');\n}\n\n// Serializes an error and its cause chain into a array of serialised error objects;\n// errors are ordered from outermost to root cause;\n// cycles in the cause chain are safely ignored;\n// messages are normalized to end with punctuation\nexport function serialiseError(error?: unknown): SerialisedError[] {\n    const seenCauses = new Set();\n    const serialisedErrors: SerialisedError[] = [];\n    let cause: Error | null = normalizeToError(error);\n    while (cause != null && !seenCauses.has(cause)) {\n        seenCauses.add(cause);\n        const [serialisedError, nextCause] = serialiseSingleError(cause);\n        if (!/(?:\\.{3}|[.!?])$/.test(serialisedError.message)) serialisedError.message += '.';\n        serialisedErrors.push(serialisedError);\n        cause = nextCause;\n    }\n    return serialisedErrors;\n}\n\n// Unserialises an array of serialised error objects back into an error with a cause chain;\n// reconstructs the appropriate error class based on serialized properties;\n// chains errors from outermost to root cause using the `cause` option;\n// returns a placeholder error if the input array is empty\nexport function unserialiseError(serialisedErrors: SerialisedError[]): Error {\n    // Build the error chain from root cause (end) to outermost (start)\n    let rebuiltError: Error | undefined;\n    for (const serialised of serialisedErrors.toReversed()) {\n        const error = reconstructError(serialised, rebuiltError);\n        if (serialised.stack !== undefined) error.stack = serialised.stack; // Restore stack trace if available\n        rebuiltError = error;\n    }\n    return rebuiltError ?? new Error('No error to unserialise.');\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Builds a fallback message for non-error throwables\nfunction buildFallbackMessage(cause: unknown): string {\n    let fallbackMessage: string;\n    try {\n        fallbackMessage = JSON.stringify(cause);\n    } catch {\n        if (typeof cause === 'symbol') fallbackMessage = cause.description ?? 'Unknown error';\n        else if (typeof cause === 'bigint') fallbackMessage = cause.toString();\n        else fallbackMessage = 'Unknown error';\n    }\n    if (fallbackMessage === '') fallbackMessage = 'Unknown error';\n    return fallbackMessage;\n}\n\nfunction reconstructError(serialised: SerialisedError, cause: Error | undefined): Error {\n    switch (serialised.name) {\n        case 'APIError':\n            return new APIError(serialised.message, serialised.locator, serialised.data, { cause });\n        case 'AppError':\n            return new AppError(serialised.message, serialised.locator, serialised.data, { cause });\n        case 'ConnectorError':\n            return new ConnectorError(serialised.message, serialised.locator, serialised.data, { cause });\n        case 'EngineError':\n            return new EngineError(serialised.message, serialised.locator, serialised.data, { cause });\n        case 'FetchError':\n            return new FetchError(serialised.message, serialised.locator, serialised.data, { cause });\n        default: {\n            const name = serialised.name;\n            return new (class extends Error {\n                override name = name;\n            })(serialised.message, { cause });\n        }\n    }\n}\n\n// Sanitizes a response body; limits body size to avoid excessive payloads when logging\nfunction sanitizeResponseErrorBody(body?: string): string | undefined {\n    if (body == null || body === '') return undefined;\n    return body.length > RESPONSE_ERROR_BODY_LIMIT ? `${body.slice(0, RESPONSE_ERROR_BODY_LIMIT)}... [truncated]` : body;\n}\n\nfunction serialiseSingleError(cause: Error): [SerialisedError, Error | null] {\n    const nextCause = cause.cause == null ? null : normalizeToError(cause.cause);\n    if (cause instanceof DPUseError) {\n        return [{ data: cause.data, locator: cause.locator, message: cause.message, name: cause.name, stack: cause.stack }, nextCause];\n    }\n    const customProperties = Object.fromEntries(Object.entries(cause).filter(([k]) => k !== 'cause'));\n    return cause.name\n        ? [{ data: customProperties, locator: '', message: cause.message, name: cause.name, stack: cause.stack }, nextCause]\n        : [{ data: customProperties, locator: '', message: buildFallbackMessage(cause), name: 'Error', stack: undefined }, null];\n}\n"],"mappings":"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"}
+{"version":3,"file":"dpuse-shared-errors.es.js","names":[],"sources":["../src/errors/index.ts"],"sourcesContent":["// ── Types ────────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Serializable representation of an error; used for transporting errors across api and worker boundaries\nexport interface SerialisedError {\n    data: Record<string, unknown> | undefined;\n    locator: string; // Error locator 'package.module.method'\n    message: string; // Human-readable error message\n    name: string; // Error class or type name\n    stack: string | undefined; // Stack trace if available\n}\n\n// ── Constants  ───────────────────────────────────────────────────────────────────────────────────────────────────────\n\nconst RESPONSE_ERROR_BODY_LIMIT = 2048;\n\n// Redaction — serialised errors are shown in the browser and stored in Axiom, so secrets and email addresses are masked\n// first. Best effort: it catches the common shapes, not every possible secret.\nconst REDACTED = '[REDACTED]';\nconst REDACTION_MAX_DEPTH = 10; // Deeper 'data' is replaced whole rather than walked.\nconst SECRET_KEY_PATTERN = /api[-_]?key|authori[sz]ation|cookie|credential|passw(?:or)?d|private[-_]?key|secret|token/i; // A 'data' field whose name matches has its whole value masked.\n// Each pattern is anchored to the start of a word, so it runs in linear time even over a long response body.\nconst SECRET_TEXT_PATTERNS: [RegExp, (match: string, ...groups: string[]) => string][] = [\n    [/\\b(Bearer|Basic) +[\\w.~+/=-]+/gi, (_match, scheme) => `${scheme} ${REDACTED}`], // Authorisation header values.\n    // Any 'name: value' or 'name=value' pair, in JSON, query strings, form bodies or headers; masked when the name looks\n    // secret. A bare 'Basic' or 'Bearer' value is the scheme left by the pattern above, whose token is already masked.\n    [\n        /(?<![\\w-])([\\w-]+)([\"']?[ \\t]*[:=][ \\t]*[\"']?)([^\\s\"'&,;}?#]+)/g,\n        (match, name, separator, value) => (SECRET_KEY_PATTERN.test(name) && !/^(?:Basic|Bearer)$/i.test(value) ? `${name}${separator}${REDACTED}` : match)\n    ],\n    [/\\beyJ[\\w-]+\\.[\\w-]+\\.[\\w-]*/g, () => REDACTED], // JSON web tokens.\n    [/\\b(?:sk-|xaat-|xapt-|sl\\.)[\\w-]{16,}/g, () => REDACTED], // Known token prefixes: OpenAI, Anthropic, Axiom, Dropbox.\n    [/(?<![\\w.+-])[\\w.+-]+@[\\w-]+\\.[\\w.-]+/g, () => REDACTED] // Email addresses.\n];\n\n// ── Errors ───────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Base class for all DPUse  errors; includes a locator for the error; never thrown directly\nexport class DPUseError extends Error {\n    readonly data: Record<string, unknown> | undefined;\n    readonly locator: string; // Error locator 'package.module.method'\n    constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n        super(message, options);\n        this.name = 'DPUseError';\n        this.data = data;\n        this.locator = locator;\n    }\n}\n\n// Thrown when an app (studio/assistant) error occurs\nexport class AppError extends DPUseError {\n    constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n        super(message, locator, data, options);\n        this.name = 'AppError';\n    }\n}\n\n// Thrown when an API request fails\nexport class APIError extends DPUseError {\n    constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n        super(message, locator, data, options);\n        this.name = 'APIError';\n    }\n}\n\n// Thrown when an engine request fails\nexport class EngineError extends DPUseError {\n    constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n        super(message, locator, data, options);\n        this.name = 'EngineError';\n    }\n}\n\n// Thrown when an connector operation fails; will always be wrapped in an engine error\nexport class ConnectorError extends DPUseError {\n    constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n        super(message, locator, data, options);\n        this.name = 'ConnectorError';\n    }\n}\n\n// Thrown when an HTTP request fails; may include a sanitized portion of the response body for diagnostic purposes\nexport class FetchError extends DPUseError {\n    constructor(message: string, locator: string, data?: Record<string, unknown>, options?: ErrorOptions) {\n        super(message, locator, data, options);\n        this.name = 'FetchError';\n    }\n}\n\n// ── Actions ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Builds a fetch error from an HTTP response; includes a text copy of the response body\nexport async function buildFetchError(response: { status: number; statusText: string; text: () => Promise<string> }, message: string, locator: string): Promise<FetchError> {\n    const responseStatusStuff = ` - ${response.statusText}`;\n    const fetchMessage = `${message} Response status '${String(response.status)}${response.statusText ? responseStatusStuff : ''}' received.`;\n    let bodyText: string;\n    try {\n        bodyText = await response.text();\n    } catch (error) {\n        const normalised = normalizeToError(error);\n        bodyText = `<body unavailable: ${normalised.message}>`;\n    }\n    return new FetchError(fetchMessage, locator, { body: sanitizeResponseErrorBody(bodyText) });\n}\n\n// Concatenates serialized error messages into a single string\nexport function concatenateSerialisedErrorMessages(serialisedErrors: SerialisedError[]): string {\n    return serialisedErrors.map((serialisedError) => serialisedError.message).join(' ');\n}\n\n// Ignore best-effort cleanup errors to keep teardown noise-free\nexport function ignoreErrors(action: () => void): void {\n    try {\n        action();\n    } catch {\n        // Intentionally ignore errors\n    }\n}\n\n// Normalizes an unknown thrown value into an error\nexport function normalizeToError(value: unknown): Error {\n    if (value instanceof Error) return value;\n    if (typeof value === 'string') return new Error(value);\n    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') return new Error(String(value));\n    if (typeof value === 'symbol') return new Error(value.description ?? 'Unknown error');\n    if (typeof value === 'object') {\n        try {\n            return new Error(JSON.stringify(value));\n        } catch {\n            return new Error('Unknown error');\n        }\n    }\n    return new Error('Unknown error');\n}\n\n// Serializes an error and its cause chain into a array of serialised error objects;\n// errors are ordered from outermost to root cause;\n// cycles in the cause chain are safely ignored;\n// messages are normalized to end with punctuation;\n// secrets and email addresses in messages, stacks and data are redacted\nexport function serialiseError(error?: unknown): SerialisedError[] {\n    const seenCauses = new Set();\n    const serialisedErrors: SerialisedError[] = [];\n    let cause: Error | null = normalizeToError(error);\n    while (cause != null && !seenCauses.has(cause)) {\n        seenCauses.add(cause);\n        const [serialisedError, nextCause] = serialiseSingleError(cause);\n        if (!/(?:\\.{3}|[.!?])$/.test(serialisedError.message)) serialisedError.message += '.';\n        serialisedErrors.push(redactSerialisedError(serialisedError));\n        cause = nextCause;\n    }\n    return serialisedErrors;\n}\n\n// Unserialises an array of serialised error objects back into an error with a cause chain;\n// reconstructs the appropriate error class based on serialized properties;\n// chains errors from outermost to root cause using the `cause` option;\n// returns a placeholder error if the input array is empty\nexport function unserialiseError(serialisedErrors: SerialisedError[]): Error {\n    // Build the error chain from root cause (end) to outermost (start)\n    let rebuiltError: Error | undefined;\n    for (const serialised of serialisedErrors.toReversed()) {\n        const error = reconstructError(serialised, rebuiltError);\n        if (serialised.stack !== undefined) error.stack = serialised.stack; // Restore stack trace if available\n        rebuiltError = error;\n    }\n    return rebuiltError ?? new Error('No error to unserialise.');\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────────────────────────────────────────────────────\n\n// Builds a fallback message for non-error throwables\nfunction buildFallbackMessage(cause: unknown): string {\n    let fallbackMessage: string;\n    try {\n        fallbackMessage = JSON.stringify(cause);\n    } catch {\n        if (typeof cause === 'symbol') fallbackMessage = cause.description ?? 'Unknown error';\n        else if (typeof cause === 'bigint') fallbackMessage = cause.toString();\n        else fallbackMessage = 'Unknown error';\n    }\n    if (fallbackMessage === '') fallbackMessage = 'Unknown error';\n    return fallbackMessage;\n}\n\nfunction reconstructError(serialised: SerialisedError, cause: Error | undefined): Error {\n    switch (serialised.name) {\n        case 'APIError':\n            return new APIError(serialised.message, serialised.locator, serialised.data, { cause });\n        case 'AppError':\n            return new AppError(serialised.message, serialised.locator, serialised.data, { cause });\n        case 'ConnectorError':\n            return new ConnectorError(serialised.message, serialised.locator, serialised.data, { cause });\n        case 'EngineError':\n            return new EngineError(serialised.message, serialised.locator, serialised.data, { cause });\n        case 'FetchError':\n            return new FetchError(serialised.message, serialised.locator, serialised.data, { cause });\n        default: {\n            const name = serialised.name;\n            return new (class extends Error {\n                override name = name;\n            })(serialised.message, { cause });\n        }\n    }\n}\n\nfunction redactSerialisedError(serialisedError: SerialisedError): SerialisedError {\n    const { data, message, stack } = serialisedError;\n    return {\n        ...serialisedError,\n        data: data === undefined ? undefined : (redactValue(data, new WeakSet(), 0) as Record<string, unknown>),\n        message: redactText(message),\n        stack: stack === undefined ? undefined : redactText(stack)\n    };\n}\n\nfunction redactText(text: string): string {\n    let redactedText = text;\n    for (const [pattern, replacement] of SECRET_TEXT_PATTERNS)\n        redactedText = redactedText.replaceAll(pattern, (match: string, ...groups: string[]) => replacement(match, ...groups));\n    return redactedText;\n}\n\n// Walks 'data', masking any field whose name looks secret and any secret found in text.\nfunction redactValue(value: unknown, seen: WeakSet<object>, depth: number): unknown {\n    if (typeof value === 'string') return redactText(value);\n    if (typeof value !== 'object' || value === null) return value;\n    if (depth >= REDACTION_MAX_DEPTH) return REDACTED;\n    if (seen.has(value)) return '[Circular]';\n    seen.add(value);\n    return Array.isArray(value)\n        ? value.map((item) => redactValue(item, seen, depth + 1))\n        : Object.fromEntries(\n              Object.entries(value).map(([key, entryValue]) => [key, entryValue != null && SECRET_KEY_PATTERN.test(key) ? REDACTED : redactValue(entryValue, seen, depth + 1)])\n          );\n}\n\n// Sanitizes a response body; limits body size to avoid excessive payloads when logging\nfunction sanitizeResponseErrorBody(body?: string): string | undefined {\n    if (body == null || body === '') return undefined;\n    return body.length > RESPONSE_ERROR_BODY_LIMIT ? `${body.slice(0, RESPONSE_ERROR_BODY_LIMIT)}... [truncated]` : body;\n}\n\nfunction serialiseSingleError(cause: Error): [SerialisedError, Error | null] {\n    const nextCause = cause.cause == null ? null : normalizeToError(cause.cause);\n    if (cause instanceof DPUseError) {\n        return [{ data: cause.data, locator: cause.locator, message: cause.message, name: cause.name, stack: cause.stack }, nextCause];\n    }\n    const customProperties = Object.fromEntries(Object.entries(cause).filter(([k]) => k !== 'cause'));\n    return cause.name\n        ? [{ data: customProperties, locator: '', message: cause.message, name: cause.name, stack: cause.stack }, nextCause]\n        : [{ data: customProperties, locator: '', message: buildFallbackMessage(cause), name: 'Error', stack: undefined }, null];\n}\n"],"mappings":";AAaA,IAAM,IAA4B,MAI5B,IAAW,cAEX,IAAqB,8FAErB,IAAmF;CACrF,CAAC,oCAAoC,GAAQ,MAAW,GAAG,EAAO,GAAG,GAAU;CAG/E,CACI,oEACC,GAAO,GAAM,GAAW,MAAW,EAAmB,KAAK,CAAI,KAAK,CAAC,sBAAsB,KAAK,CAAK,IAAI,GAAG,IAAO,IAAY,MAAa,CACjJ;CACA,CAAC,sCAAsC,CAAQ;CAC/C,CAAC,+CAA+C,CAAQ;CACxD,CAAC,+CAA+C,CAAQ;AAC5D,GAKa,IAAb,cAAgC,MAAM;CAClC;CACA;CACA,YAAY,GAAiB,GAAiB,GAAgC,GAAwB;EAIlG,AAHA,MAAM,GAAS,CAAO,GACtB,KAAK,OAAO,cACZ,KAAK,OAAO,GACZ,KAAK,UAAU;CACnB;AACJ,GAGa,IAAb,cAA8B,EAAW;CACrC,YAAY,GAAiB,GAAiB,GAAgC,GAAwB;EAElG,AADA,MAAM,GAAS,GAAS,GAAM,CAAO,GACrC,KAAK,OAAO;CAChB;AACJ,GAGa,IAAb,cAA8B,EAAW;CACrC,YAAY,GAAiB,GAAiB,GAAgC,GAAwB;EAElG,AADA,MAAM,GAAS,GAAS,GAAM,CAAO,GACrC,KAAK,OAAO;CAChB;AACJ,GAGa,IAAb,cAAiC,EAAW;CACxC,YAAY,GAAiB,GAAiB,GAAgC,GAAwB;EAElG,AADA,MAAM,GAAS,GAAS,GAAM,CAAO,GACrC,KAAK,OAAO;CAChB;AACJ,GAGa,IAAb,cAAoC,EAAW;CAC3C,YAAY,GAAiB,GAAiB,GAAgC,GAAwB;EAElG,AADA,MAAM,GAAS,GAAS,GAAM,CAAO,GACrC,KAAK,OAAO;CAChB;AACJ,GAGa,IAAb,cAAgC,EAAW;CACvC,YAAY,GAAiB,GAAiB,GAAgC,GAAwB;EAElG,AADA,MAAM,GAAS,GAAS,GAAM,CAAO,GACrC,KAAK,OAAO;CAChB;AACJ;AAKA,eAAsB,EAAgB,GAA+E,GAAiB,GAAsC;CACxK,IAAM,IAAsB,MAAM,EAAS,cACrC,IAAe,GAAG,EAAQ,oBAAoB,OAAO,EAAS,MAAM,IAAI,EAAS,aAAa,IAAsB,GAAG,cACzH;CACJ,IAAI;EACA,IAAW,MAAM,EAAS,KAAK;CACnC,SAAS,GAAO;EAEZ,IAAW,sBADQ,EAAiB,CACH,CAAA,CAAW,QAAQ;CACxD;CACA,OAAO,IAAI,EAAW,GAAc,GAAS,EAAE,MAAM,EAA0B,CAAQ,EAAE,CAAC;AAC9F;AAGA,SAAgB,EAAmC,GAA6C;CAC5F,OAAO,EAAiB,KAAK,MAAoB,EAAgB,OAAO,CAAC,CAAC,KAAK,GAAG;AACtF;AAGA,SAAgB,EAAa,GAA0B;CACnD,IAAI;EACA,EAAO;CACX,QAAQ,CAER;AACJ;AAGA,SAAgB,EAAiB,GAAuB;CACpD,IAAI,aAAiB,OAAO,OAAO;CACnC,IAAI,OAAO,KAAU,UAAU,OAAW,MAAM,CAAK;CACrD,IAAI,OAAO,KAAU,YAAY,OAAO,KAAU,aAAa,OAAO,KAAU,UAAU,OAAW,MAAM,OAAO,CAAK,CAAC;CACxH,IAAI,OAAO,KAAU,UAAU,OAAW,MAAM,EAAM,eAAe,eAAe;CACpF,IAAI,OAAO,KAAU,UACjB,IAAI;EACA,OAAW,MAAM,KAAK,UAAU,CAAK,CAAC;CAC1C,QAAQ;EACJ,OAAO,gBAAI,MAAM,eAAe;CACpC;CAEJ,OAAO,gBAAI,MAAM,eAAe;AACpC;AAOA,SAAgB,EAAe,GAAoC;CAC/D,IAAM,oBAAa,IAAI,IAAI,GACrB,IAAsC,CAAC,GACzC,IAAsB,EAAiB,CAAK;CAChD,OAAO,KAAS,QAAQ,CAAC,EAAW,IAAI,CAAK,IAAG;EAC5C,EAAW,IAAI,CAAK;EACpB,IAAM,CAAC,GAAiB,KAAa,EAAqB,CAAK;EAG/D,AAFK,mBAAmB,KAAK,EAAgB,OAAO,MAAG,EAAgB,WAAW,MAClF,EAAiB,KAAK,EAAsB,CAAe,CAAC,GAC5D,IAAQ;CACZ;CACA,OAAO;AACX;AAMA,SAAgB,EAAiB,GAA4C;CAEzE,IAAI;CACJ,KAAK,IAAM,KAAc,EAAiB,WAAW,GAAG;EACpD,IAAM,IAAQ,EAAiB,GAAY,CAAY;EAEvD,AADI,EAAW,UAAU,KAAA,MAAW,EAAM,QAAQ,EAAW,QAC7D,IAAe;CACnB;CACA,OAAO,KAAgB,gBAAI,MAAM,0BAA0B;AAC/D;AAKA,SAAS,EAAqB,GAAwB;CAClD,IAAI;CACJ,IAAI;EACA,IAAkB,KAAK,UAAU,CAAK;CAC1C,QAAQ;EACJ,AAEK,IAFD,OAAO,KAAU,WAA4B,EAAM,eAAe,kBAC7D,OAAO,KAAU,WAA4B,EAAM,SAAS,IAC9C;CAC3B;CAEA,OADI,MAAoB,OAAI,IAAkB,kBACvC;AACX;AAEA,SAAS,EAAiB,GAA6B,GAAiC;CACpF,QAAQ,EAAW,MAAnB;EACI,KAAK,YACD,OAAO,IAAI,EAAS,EAAW,SAAS,EAAW,SAAS,EAAW,MAAM,EAAE,SAAM,CAAC;EAC1F,KAAK,YACD,OAAO,IAAI,EAAS,EAAW,SAAS,EAAW,SAAS,EAAW,MAAM,EAAE,SAAM,CAAC;EAC1F,KAAK,kBACD,OAAO,IAAI,EAAe,EAAW,SAAS,EAAW,SAAS,EAAW,MAAM,EAAE,SAAM,CAAC;EAChG,KAAK,eACD,OAAO,IAAI,EAAY,EAAW,SAAS,EAAW,SAAS,EAAW,MAAM,EAAE,SAAM,CAAC;EAC7F,KAAK,cACD,OAAO,IAAI,EAAW,EAAW,SAAS,EAAW,SAAS,EAAW,MAAM,EAAE,SAAM,CAAC;EAC5F,SAAS;GACL,IAAM,IAAO,EAAW;GACxB,OAAO,IAAK,cAAc,MAAM;IAC5B,OAAgB;GACpB,EAAG,EAAW,SAAS,EAAE,SAAM,CAAC;EACpC;CACJ;AACJ;AAEA,SAAS,EAAsB,GAAmD;CAC9E,IAAM,EAAE,SAAM,YAAS,aAAU;CACjC,OAAO;EACH,GAAG;EACH,MAAM,MAAS,KAAA,IAAY,KAAA,IAAa,EAAY,mBAAM,IAAI,QAAQ,GAAG,CAAC;EAC1E,SAAS,EAAW,CAAO;EAC3B,OAAO,MAAU,KAAA,IAAY,KAAA,IAAY,EAAW,CAAK;CAC7D;AACJ;AAEA,SAAS,EAAW,GAAsB;CACtC,IAAI,IAAe;CACnB,KAAK,IAAM,CAAC,GAAS,MAAgB,GACjC,IAAe,EAAa,WAAW,IAAU,GAAe,GAAG,MAAqB,EAAY,GAAO,GAAG,CAAM,CAAC;CACzH,OAAO;AACX;AAGA,SAAS,EAAY,GAAgB,GAAuB,GAAwB;CAMhF,OALI,OAAO,KAAU,WAAiB,EAAW,CAAK,IAClD,OAAO,KAAU,aAAY,IAAuB,IACpD,KAAS,KAA4B,IACrC,EAAK,IAAI,CAAK,IAAU,gBAC5B,EAAK,IAAI,CAAK,GACP,MAAM,QAAQ,CAAK,IACpB,EAAM,KAAK,MAAS,EAAY,GAAM,GAAM,IAAQ,CAAC,CAAC,IACtD,OAAO,YACH,OAAO,QAAQ,CAAK,CAAC,CAAC,KAAK,CAAC,GAAK,OAAgB,CAAC,GAAK,KAAc,QAAQ,EAAmB,KAAK,CAAG,IAAI,IAAW,EAAY,GAAY,GAAM,IAAQ,CAAC,CAAC,CAAC,CACpK;AACV;AAGA,SAAS,EAA0B,GAAmC;CAClE,IAAI,KAAQ,QAAQ,MAAS,IAC7B,OAAO,EAAK,SAAS,IAA4B,GAAG,EAAK,MAAM,GAAG,CAAyB,EAAE,mBAAmB;AACpH;AAEA,SAAS,EAAqB,GAA+C;CACzE,IAAM,IAAY,EAAM,SAAS,OAAO,OAAO,EAAiB,EAAM,KAAK;CAC3E,IAAI,aAAiB,GACjB,OAAO,CAAC;EAAE,MAAM,EAAM;EAAM,SAAS,EAAM;EAAS,SAAS,EAAM;EAAS,MAAM,EAAM;EAAM,OAAO,EAAM;CAAM,GAAG,CAAS;CAEjI,IAAM,IAAmB,OAAO,YAAY,OAAO,QAAQ,CAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,MAAM,OAAO,CAAC;CAChG,OAAO,EAAM,OACP,CAAC;EAAE,MAAM;EAAkB,SAAS;EAAI,SAAS,EAAM;EAAS,MAAM,EAAM;EAAM,OAAO,EAAM;CAAM,GAAG,CAAS,IACjH,CAAC;EAAE,MAAM;EAAkB,SAAS;EAAI,SAAS,EAAqB,CAAK;EAAG,MAAM;EAAS,OAAO,KAAA;CAAU,GAAG,IAAI;AAC/H"}

package/dist/types/src/component/module/connector/connectorConfig.schema.d.ts

@@ -9,7 +9,7 @@ export declare const connectorCategoryConfigSchema: import('valibot').StrictObje
         readonly es: import('valibot').StringSchema<undefined>;
     }, undefined>;
 }, undefined>;
-export declare const connectorUsageIdSchema: import('valibot').UnionSchema<readonly [import('valibot').LiteralSchema<"bidirectional", undefined>, import('valibot').LiteralSchema<"destination", undefined>, import('valibot').LiteralSchema<"source", undefined>], undefined>;
+export declare const connectorUsageIdSchema: import('valibot').UnionSchema<readonly [import('valibot').LiteralSchema<"bidirectional", undefined>, import('valibot').LiteralSchema<"destination", undefined>, import('valibot').LiteralSchema<"source", undefined>, import('valibot').LiteralSchema<"unknown", undefined>], undefined>;
 export declare const connectorUsageConfigSchema: import('valibot').StrictObjectSchema<{
     readonly label: import('valibot').StrictObjectSchema<{
         readonly en: import('valibot').StringSchema<undefined>;
@@ -44,7 +44,7 @@ export declare const connectorConfigSchema: import('valibot').StrictObjectSchema
             readonly es: import('valibot').StringSchema<undefined>;
         }, undefined>;
     }, undefined>, undefined>;
-    readonly usageId: import('valibot').NullableSchema<import('valibot').UnionSchema<readonly [import('valibot').LiteralSchema<"bidirectional", undefined>, import('valibot').LiteralSchema<"destination", undefined>, import('valibot').LiteralSchema<"source", undefined>], undefined>, undefined>;
+    readonly usageId: import('valibot').NullableSchema<import('valibot').UnionSchema<readonly [import('valibot').LiteralSchema<"bidirectional", undefined>, import('valibot').LiteralSchema<"destination", undefined>, import('valibot').LiteralSchema<"source", undefined>, import('valibot').LiteralSchema<"unknown", undefined>], undefined>, undefined>;
     readonly vendorAccountURL: import('valibot').NullableSchema<import('valibot').StringSchema<undefined>, undefined>;
     readonly vendorDocumentationURL: import('valibot').NullableSchema<import('valibot').StringSchema<undefined>, undefined>;
     readonly vendorHomeURL: import('valibot').NullableSchema<import('valibot').StringSchema<undefined>, undefined>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@dpuse/dpuse-shared",
-    "version": "0.3.824",
+    "version": "0.3.829",
     "private": false,
     "description": "Common constants, types and utilities used across all DPUse projects.",
     "license": "MIT",
@@ -170,10 +170,10 @@
         "valibot": "^1.5.0"
     },
     "devDependencies": {
-        "@dpuse/dpuse-development": "^0.3.722",
-        "@dpuse/eslint-config-dpuse": "^1.0.122",
+        "@dpuse/dpuse-development": "^0.3.723",
+        "@dpuse/eslint-config-dpuse": "^1.0.123",
         "@types/node": "^26.6.2",
-        "@vitest/coverage-v8": "^5.0.1",
+        "@vitest/coverage-v8": "^5.0.2",
         "eslint": "^10.11.0",
         "fallow": "^3.28.0",
         "prettier": "^3.9.9",
@@ -181,6 +181,6 @@
         "typescript": "^6.0.3",
         "vite": "^8.3.1",
         "vite-plugin-dts": "^5.1.1",
-        "vitest": "^5.0.1"
+        "vitest": "^5.0.2"
     }
 }