@thymian/plugin-har 0.1.7-canary.20260420-67bb013

package/dist/har-schema.d.ts

@@ -0,0 +1,4 @@
+import type { HarLog } from './har-types.js';
+export declare function validateHar(data: unknown): data is HarLog;
+export declare function getValidationErrors(): string;
+//# sourceMappingURL=har-schema.d.ts.map

package/dist/har-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-schema.d.ts","sourceRoot":"","sources":["../src/har-schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAkG7C,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAEzD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/har-schema.js

@@ -0,0 +1,102 @@
+import { ajv } from '@thymian/core';
+/**
+ * Minimal JSON Schema for HAR 1.2 structure validation.
+ * Validates only the fields consumed by the plugin — additional
+ * HAR properties are allowed via `additionalProperties: true`.
+ */
+const harLogSchema = {
+    type: 'object',
+    required: ['log'],
+    additionalProperties: true,
+    properties: {
+        log: {
+            type: 'object',
+            required: ['entries'],
+            additionalProperties: true,
+            properties: {
+                version: { type: 'string' },
+                entries: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        required: ['request', 'time'],
+                        additionalProperties: true,
+                        properties: {
+                            time: { type: 'number' },
+                            request: {
+                                type: 'object',
+                                required: ['method', 'url', 'headers'],
+                                additionalProperties: true,
+                                properties: {
+                                    method: { type: 'string' },
+                                    url: { type: 'string' },
+                                    headers: {
+                                        type: 'array',
+                                        items: {
+                                            type: 'object',
+                                            required: ['name', 'value'],
+                                            additionalProperties: true,
+                                            properties: {
+                                                name: { type: 'string' },
+                                                value: { type: 'string' },
+                                            },
+                                        },
+                                    },
+                                    postData: {
+                                        type: 'object',
+                                        nullable: true,
+                                        additionalProperties: true,
+                                        properties: {
+                                            text: { type: 'string', nullable: true },
+                                            mimeType: { type: 'string', nullable: true },
+                                        },
+                                    },
+                                },
+                            },
+                            response: {
+                                type: 'object',
+                                nullable: true,
+                                required: ['status', 'headers', 'content'],
+                                additionalProperties: true,
+                                properties: {
+                                    status: { type: 'number' },
+                                    headers: {
+                                        type: 'array',
+                                        items: {
+                                            type: 'object',
+                                            required: ['name', 'value'],
+                                            additionalProperties: true,
+                                            properties: {
+                                                name: { type: 'string' },
+                                                value: { type: 'string' },
+                                            },
+                                        },
+                                    },
+                                    content: {
+                                        type: 'object',
+                                        required: ['size'],
+                                        additionalProperties: true,
+                                        properties: {
+                                            text: { type: 'string', nullable: true },
+                                            size: { type: 'number' },
+                                            mimeType: { type: 'string', nullable: true },
+                                            encoding: { type: 'string', nullable: true },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};
+const validateFn = ajv.compile(harLogSchema);
+export function validateHar(data) {
+    return validateFn(data);
+}
+export function getValidationErrors() {
+    return ajv.errorsText(validateFn.errors);
+}
+//# sourceMappingURL=har-schema.js.map

package/dist/har-schema.js.map

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

package/dist/har-transformer.d.ts

@@ -0,0 +1,14 @@
+import type { CapturedTransaction, HttpParticipantRole } from '@thymian/core';
+import type { HarEntry, HarHeader, HarLog } from './har-types.js';
+export declare function transformHarHeaders(headers: HarHeader[]): Record<string, string | string[] | undefined>;
+export declare function parseUrl(url: string): {
+    origin: string;
+    path: string;
+};
+export declare function transformHarEntry(entry: HarEntry, clientRole: HttpParticipantRole, serverRole: HttpParticipantRole): CapturedTransaction | null;
+export declare function transformHar(har: HarLog, clientRole: HttpParticipantRole, serverRole: HttpParticipantRole): {
+    transactions: CapturedTransaction[];
+    skippedCount: number;
+    skippedReasons: string[];
+};
+//# sourceMappingURL=har-transformer.d.ts.map

package/dist/har-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-transformer.d.ts","sourceRoot":"","sources":["../src/har-transformer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAElE,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,EAAE,GACnB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAiB/C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAMtE;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,EACf,UAAU,EAAE,mBAAmB,EAC/B,UAAU,EAAE,mBAAmB,GAC9B,mBAAmB,GAAG,IAAI,CAuC5B;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,mBAAmB,EAC/B,UAAU,EAAE,mBAAmB,GAC9B;IACD,YAAY,EAAE,mBAAmB,EAAE,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CA4BA"}

package/dist/har-transformer.js

@@ -0,0 +1,90 @@
+export function transformHarHeaders(headers) {
+    const result = {};
+    for (const header of headers) {
+        const key = header.name.toLowerCase();
+        const existing = result[key];
+        if (existing === undefined) {
+            result[key] = header.value;
+        }
+        else if (Array.isArray(existing)) {
+            existing.push(header.value);
+        }
+        else {
+            result[key] = [existing, header.value];
+        }
+    }
+    return result;
+}
+export function parseUrl(url) {
+    const parsed = new URL(url);
+    return {
+        origin: parsed.origin,
+        path: parsed.pathname + parsed.search,
+    };
+}
+export function transformHarEntry(entry, clientRole, serverRole) {
+    if (!entry.response) {
+        return null;
+    }
+    let origin;
+    let path;
+    try {
+        const parsed = parseUrl(entry.request.url);
+        origin = parsed.origin;
+        path = parsed.path;
+    }
+    catch {
+        return null;
+    }
+    return {
+        request: {
+            data: {
+                method: entry.request.method.toLowerCase(),
+                origin,
+                path,
+                headers: transformHarHeaders(entry.request.headers),
+                body: entry.request.postData?.text,
+            },
+            meta: { role: clientRole },
+        },
+        response: {
+            data: {
+                statusCode: entry.response.status,
+                headers: transformHarHeaders(entry.response.headers),
+                body: entry.response.content.text,
+                bodyEncoding: entry.response.content.encoding,
+                trailers: {},
+                duration: entry.time,
+            },
+            meta: { role: serverRole },
+        },
+    };
+}
+export function transformHar(har, clientRole, serverRole) {
+    const transactions = [];
+    let skippedCount = 0;
+    const skippedReasons = [];
+    for (const entry of har.log.entries) {
+        if (!entry.response) {
+            skippedCount++;
+            skippedReasons.push('missing response');
+            continue;
+        }
+        let transaction;
+        try {
+            transaction = transformHarEntry(entry, clientRole, serverRole);
+        }
+        catch {
+            transaction = null;
+        }
+        if (transaction) {
+            transactions.push(transaction);
+        }
+        else {
+            skippedCount++;
+            skippedReasons.push('invalid request URL');
+        }
+    }
+    return { transactions, skippedCount, skippedReasons };
+}
+//# sourceMappingURL=har-transformer.js.map

package/dist/har-transformer.js.map

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

package/dist/har-types.d.ts

@@ -0,0 +1,35 @@
+export type HarHeader = {
+    name: string;
+    value: string;
+};
+export type HarRequest = {
+    method: string;
+    url: string;
+    headers: HarHeader[];
+    postData?: {
+        text?: string;
+        mimeType?: string;
+    };
+};
+export type HarResponse = {
+    status: number;
+    headers: HarHeader[];
+    content: {
+        text?: string;
+        size: number;
+        mimeType?: string;
+        encoding?: string;
+    };
+};
+export type HarEntry = {
+    request: HarRequest;
+    response?: HarResponse;
+    time: number;
+};
+export type HarLog = {
+    log: {
+        version: string;
+        entries: HarEntry[];
+    };
+};
+//# sourceMappingURL=har-types.d.ts.map

package/dist/har-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-types.d.ts","sourceRoot":"","sources":["../src/har-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,GAAG,EAAE;QACH,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,QAAQ,EAAE,CAAC;KACrB,CAAC;CACH,CAAC"}

package/dist/har-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=har-types.js.map

package/dist/har-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-types.js","sourceRoot":"","sources":["../src/har-types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import type { HttpParticipantRole, ThymianPlugin } from '@thymian/core';
+export type HarPluginOptions = {
+    /**
+     * Maximum allowed HAR file size in bytes.
+     * Files exceeding this limit cause a `ThymianBaseError` to be thrown.
+     * @default 52_428_800 (50 MB)
+     */
+    maxFileSize?: number;
+    /**
+     * The HTTP participant role to assign to requests loaded from HAR files.
+     * This determines which RFC rules apply to the client side of the loaded traffic.
+     * @default 'user-agent'
+     */
+    clientRole?: HttpParticipantRole;
+    /**
+     * The HTTP participant role to assign to responses loaded from HAR files.
+     * This determines which RFC rules apply to the server side of the loaded traffic.
+     * @default 'origin server'
+     */
+    serverRole?: HttpParticipantRole;
+};
+export declare function createHarPlugin(pluginName?: string): ThymianPlugin<HarPluginOptions>;
+export declare const harPlugin: ThymianPlugin<HarPluginOptions>;
+export default harPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EAEnB,aAAa,EACd,MAAM,eAAe,CAAC;AAOvB,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC;IAEjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC,CAAC;AAEF,wBAAgB,eAAe,CAC7B,UAAU,SAAwB,GACjC,aAAa,CAAC,gBAAgB,CAAC,CA0FjC;AAED,eAAO,MAAM,SAAS,iCAAoB,CAAC;AAE3C,eAAe,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,79 @@
+import { loadTransactionsFromHar } from './load-transactions.js';
+/** 50 MB — covers typical browser DevTools HAR exports. */
+const DEFAULT_MAX_FILE_SIZE_BYTES = 50 * 1024 * 1024;
+export function createHarPlugin(pluginName = '@thymian/plugin-har') {
+    return {
+        name: pluginName,
+        version: '0.x',
+        options: {
+            type: 'object',
+            nullable: true,
+            properties: {
+                maxFileSize: { type: 'number', nullable: true },
+                clientRole: {
+                    type: 'string',
+                    nullable: true,
+                    default: 'user-agent',
+                    enum: [
+                        'intermediary',
+                        'proxy',
+                        'gateway',
+                        'tunnel',
+                        'origin server',
+                        'server',
+                        'client',
+                        'user-agent',
+                        'cache',
+                    ],
+                },
+                serverRole: {
+                    type: 'string',
+                    nullable: true,
+                    default: 'origin server',
+                    enum: [
+                        'intermediary',
+                        'proxy',
+                        'gateway',
+                        'tunnel',
+                        'origin server',
+                        'server',
+                        'client',
+                        'user-agent',
+                        'cache',
+                    ],
+                },
+            },
+            additionalProperties: false,
+        },
+        actions: {
+            listensOn: ['core.traffic.load'],
+        },
+        async plugin(emitter, logger, options) {
+            const maxFileSize = options.maxFileSize ?? DEFAULT_MAX_FILE_SIZE_BYTES;
+            const clientRole = options.clientRole ?? 'user-agent';
+            const serverRole = options.serverRole ?? 'origin server';
+            emitter.onAction('core.traffic.load', async (input, ctx) => {
+                const harInputs = input.inputs.filter((i) => i.type === 'har');
+                if (harInputs.length === 0) {
+                    logger.info('No HAR inputs found, skipping HAR processing.');
+                    return ctx.reply({ transactions: [] });
+                }
+                const allTransactions = [];
+                for (const harInput of harInputs) {
+                    logger.info(`Loading traffic from HAR file: ${String(harInput.location)}`);
+                    const transactions = await loadTransactionsFromHar(String(harInput.location), logger, options.cwd, maxFileSize, clientRole, serverRole);
+                    // Avoid spread (`allTransactions.push(...transactions)`) because
+                    // large HAR files can contain thousands of entries, which would
+                    // exceed the JavaScript call-stack size limit.
+                    for (const t of transactions) {
+                        allTransactions.push(t);
+                    }
+                }
+                ctx.reply({ transactions: allTransactions });
+            });
+        },
+    };
+}
+export const harPlugin = createHarPlugin();
+export default harPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/load-transactions.d.ts

@@ -0,0 +1,10 @@
+import type { CapturedTransaction, HttpParticipantRole, Logger } from '@thymian/core';
+/**
+ * Reads a single HAR file, validates its structure, and returns
+ * the transformed transactions.
+ *
+ * @throws {ThymianBaseError} if the file is too large, unreadable,
+ *   not valid JSON, or not a valid HAR structure.
+ */
+export declare function loadTransactionsFromHar(location: string, logger: Logger, cwd: string, maxFileSize: number, clientRole: HttpParticipantRole, serverRole: HttpParticipantRole): Promise<CapturedTransaction[]>;
+//# sourceMappingURL=load-transactions.d.ts.map

package/dist/load-transactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-transactions.d.ts","sourceRoot":"","sources":["../src/load-transactions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,EACP,MAAM,eAAe,CAAC;AAMvB;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,mBAAmB,EAC/B,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAsDhC"}

package/dist/load-transactions.js

@@ -0,0 +1,52 @@
+import { readFile, stat } from 'node:fs/promises';
+import { isAbsolute, join } from 'node:path';
+import { ThymianBaseError } from '@thymian/core';
+import { getValidationErrors, validateHar } from './har-schema.js';
+import { transformHar } from './har-transformer.js';
+/**
+ * Reads a single HAR file, validates its structure, and returns
+ * the transformed transactions.
+ *
+ * @throws {ThymianBaseError} if the file is too large, unreadable,
+ *   not valid JSON, or not a valid HAR structure.
+ */
+export async function loadTransactionsFromHar(location, logger, cwd, maxFileSize, clientRole, serverRole) {
+    const filePath = isAbsolute(location) ? location : join(cwd, location);
+    // Guard against oversized files to prevent out-of-memory crashes.
+    // JSON.parse roughly doubles memory usage, so capping the file size
+    // keeps total heap impact predictable.
+    const fileStats = await stat(filePath).catch((err) => {
+        throw new ThymianBaseError(`Failed to read HAR file: ${filePath}`, {
+            cause: err instanceof Error ? err : undefined,
+        });
+    });
+    if (fileStats.size > maxFileSize) {
+        throw new ThymianBaseError(`HAR file exceeds maximum size (${fileStats.size.toString()} bytes > ${maxFileSize.toString()} bytes): ${filePath}`);
+    }
+    let content;
+    try {
+        content = await readFile(filePath, 'utf-8');
+    }
+    catch (err) {
+        throw new ThymianBaseError(`Failed to read HAR file: ${filePath}`, {
+            cause: err instanceof Error ? err : undefined,
+        });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        throw new ThymianBaseError(`Failed to parse HAR file as JSON: ${filePath}`);
+    }
+    if (!validateHar(parsed)) {
+        throw new ThymianBaseError(`Invalid HAR structure in ${filePath}: ${getValidationErrors()}`);
+    }
+    const { transactions, skippedCount, skippedReasons } = transformHar(parsed, clientRole, serverRole);
+    if (skippedCount > 0) {
+        const uniqueReasons = [...new Set(skippedReasons)].join(', ');
+        logger.warn(`Skipped ${skippedCount.toString()} HAR ${skippedCount === 1 ? 'entry' : 'entries'} in ${filePath} due to: ${uniqueReasons}`);
+    }
+    return transactions;
+}
+//# sourceMappingURL=load-transactions.js.map

package/dist/load-transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-transactions.js","sourceRoot":"","sources":["../src/load-transactions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAO7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAgB,EAChB,MAAc,EACd,GAAW,EACX,WAAmB,EACnB,UAA+B,EAC/B,UAA+B;IAE/B,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEvE,kEAAkE;IAClE,oEAAoE;IACpE,uCAAuC;IACvC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QAC5D,MAAM,IAAI,gBAAgB,CAAC,4BAA4B,QAAQ,EAAE,EAAE;YACjE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,SAAS,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,gBAAgB,CACxB,kCAAkC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,WAAW,CAAC,QAAQ,EAAE,YAAY,QAAQ,EAAE,CACpH,CAAC;IACJ,CAAC;IAED,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,gBAAgB,CAAC,4BAA4B,QAAQ,EAAE,EAAE;YACjE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,gBAAgB,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,gBAAgB,CACxB,4BAA4B,QAAQ,KAAK,mBAAmB,EAAE,EAAE,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,YAAY,CACjE,MAAM,EACN,UAAU,EACV,UAAU,CACX,CAAC;IAEF,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,CAAC,IAAI,CACT,WAAW,YAAY,CAAC,QAAQ,EAAE,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,OAAO,QAAQ,YAAY,aAAa,EAAE,CAC7H,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@thymian/plugin-har",
+  "version": "0.1.7-canary.20260420-67bb013",
+  "description": "Thymian plugin for loading HAR (HTTP Archive) files into the traffic pipeline",
+  "license": "AGPL-3.0-only",
+  "bugs": {
+    "url": "https://github.com/thymianofficial/thymian/issues"
+  },
+  "homepage": "https://thymian.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thymianofficial/thymian.git",
+    "directory": "packages/plugin-har"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "thymian",
+    "har",
+    "http-archive",
+    "traffic-loader",
+    "api-conformance"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "dependencies": {
+    "@thymian/core": "0.1.7-canary.20260420-67bb013",
+    "tslib": "^2.3.0"
+  },
+  "devDependencies": {
+    "@thymian/core-testing": "0.1.7-canary.20260420-67bb013"
+  }
+}