@xyne/workflow-sdk 2.1.0 → 2.1.2

package/dist/steps/builtin/transform.step.d.ts

@@ -1,247 +0,0 @@
-/**
- * TRANSFORM step — pure data manipulation.
- *
- * Applies a sequence of operations to the workflow context:
- * - set: write a value at a dotted path
- * - rename: move a value from one path to another
- * - remove: delete a value at a dotted path
- * - copy: copy a value from one path to another
- *
- * No services, no credentials — pure deterministic logic.
- */
-import { z } from 'zod';
-import { BaseActionStep } from '../base-step.js';
-import type { StepExecutionContext } from '../base-step.js';
-import { BuiltinStepType } from '../../types/known-types.js';
-import type { StepCategory } from '../../types/categories.js';
-export declare const TransformOpSchema: z.ZodDiscriminatedUnion<"op", [z.ZodObject<{
-    op: z.ZodLiteral<"set">;
-    path: z.ZodString;
-    value: z.ZodUnknown;
-}, "strip", z.ZodTypeAny, {
-    op: "set";
-    path: string;
-    value?: unknown;
-}, {
-    op: "set";
-    path: string;
-    value?: unknown;
-}>, z.ZodObject<{
-    op: z.ZodLiteral<"rename">;
-    from: z.ZodString;
-    to: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    op: "rename";
-    from: string;
-    to: string;
-}, {
-    op: "rename";
-    from: string;
-    to: string;
-}>, z.ZodObject<{
-    op: z.ZodLiteral<"remove">;
-    path: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    op: "remove";
-    path: string;
-}, {
-    op: "remove";
-    path: string;
-}>, z.ZodObject<{
-    op: z.ZodLiteral<"copy">;
-    from: z.ZodString;
-    to: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    op: "copy";
-    from: string;
-    to: string;
-}, {
-    op: "copy";
-    from: string;
-    to: string;
-}>]>;
-export type TransformOp = z.infer<typeof TransformOpSchema>;
-export declare const TransformStepConfigSchema: z.ZodObject<{
-    operations: z.ZodArray<z.ZodDiscriminatedUnion<"op", [z.ZodObject<{
-        op: z.ZodLiteral<"set">;
-        path: z.ZodString;
-        value: z.ZodUnknown;
-    }, "strip", z.ZodTypeAny, {
-        op: "set";
-        path: string;
-        value?: unknown;
-    }, {
-        op: "set";
-        path: string;
-        value?: unknown;
-    }>, z.ZodObject<{
-        op: z.ZodLiteral<"rename">;
-        from: z.ZodString;
-        to: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        op: "rename";
-        from: string;
-        to: string;
-    }, {
-        op: "rename";
-        from: string;
-        to: string;
-    }>, z.ZodObject<{
-        op: z.ZodLiteral<"remove">;
-        path: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        op: "remove";
-        path: string;
-    }, {
-        op: "remove";
-        path: string;
-    }>, z.ZodObject<{
-        op: z.ZodLiteral<"copy">;
-        from: z.ZodString;
-        to: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        op: "copy";
-        from: string;
-        to: string;
-    }, {
-        op: "copy";
-        from: string;
-        to: string;
-    }>]>, "many">;
-}, "strip", z.ZodTypeAny, {
-    operations: ({
-        op: "set";
-        path: string;
-        value?: unknown;
-    } | {
-        op: "rename";
-        from: string;
-        to: string;
-    } | {
-        op: "remove";
-        path: string;
-    } | {
-        op: "copy";
-        from: string;
-        to: string;
-    })[];
-}, {
-    operations: ({
-        op: "set";
-        path: string;
-        value?: unknown;
-    } | {
-        op: "rename";
-        from: string;
-        to: string;
-    } | {
-        op: "remove";
-        path: string;
-    } | {
-        op: "copy";
-        from: string;
-        to: string;
-    })[];
-}>;
-export type TransformStepConfig = z.infer<typeof TransformStepConfigSchema>;
-export interface TransformStepOutput extends Record<string, unknown> {
-    applied: number;
-}
-export declare class TransformStep extends BaseActionStep<typeof TransformStepConfigSchema, TransformStepOutput> {
-    readonly type = BuiltinStepType.TRANSFORM;
-    readonly name = "Transform";
-    readonly description = "Apply data transformations to the workflow context";
-    readonly configSchema: z.ZodObject<{
-        operations: z.ZodArray<z.ZodDiscriminatedUnion<"op", [z.ZodObject<{
-            op: z.ZodLiteral<"set">;
-            path: z.ZodString;
-            value: z.ZodUnknown;
-        }, "strip", z.ZodTypeAny, {
-            op: "set";
-            path: string;
-            value?: unknown;
-        }, {
-            op: "set";
-            path: string;
-            value?: unknown;
-        }>, z.ZodObject<{
-            op: z.ZodLiteral<"rename">;
-            from: z.ZodString;
-            to: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            op: "rename";
-            from: string;
-            to: string;
-        }, {
-            op: "rename";
-            from: string;
-            to: string;
-        }>, z.ZodObject<{
-            op: z.ZodLiteral<"remove">;
-            path: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            op: "remove";
-            path: string;
-        }, {
-            op: "remove";
-            path: string;
-        }>, z.ZodObject<{
-            op: z.ZodLiteral<"copy">;
-            from: z.ZodString;
-            to: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            op: "copy";
-            from: string;
-            to: string;
-        }, {
-            op: "copy";
-            from: string;
-            to: string;
-        }>]>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        operations: ({
-            op: "set";
-            path: string;
-            value?: unknown;
-        } | {
-            op: "rename";
-            from: string;
-            to: string;
-        } | {
-            op: "remove";
-            path: string;
-        } | {
-            op: "copy";
-            from: string;
-            to: string;
-        })[];
-    }, {
-        operations: ({
-            op: "set";
-            path: string;
-            value?: unknown;
-        } | {
-            op: "rename";
-            from: string;
-            to: string;
-        } | {
-            op: "remove";
-            path: string;
-        } | {
-            op: "copy";
-            from: string;
-            to: string;
-        })[];
-    }>;
-    readonly outputSchema: z.ZodObject<{
-        applied: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        applied: number;
-    }, {
-        applied: number;
-    }>;
-    readonly category: StepCategory;
-    readonly icon = "filter";
-    execute(config: TransformStepConfig, ctx: StepExecutionContext): Promise<TransformStepOutput>;
-}
-//# sourceMappingURL=transform.step.d.ts.map

package/dist/steps/builtin/transform.step.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transform.step.d.ts","sourceRoot":"","sources":["../../../src/steps/builtin/transform.step.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AA4B9D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAK5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAI5E,MAAM,WAAW,mBAAoB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AA+DD,qBAAa,aAAc,SAAQ,cAAc,CAC/C,OAAO,yBAAyB,EAChC,mBAAmB,CACpB;IACC,SAAkB,IAAI,6BAA6B;IACnD,SAAkB,IAAI,eAAe;IACrC,SAAkB,WAAW,wDAAwD;IACrF,SAAkB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA6B;IAC3D,SAAkB,YAAY;;;;;;OAA6B;IAC3D,SAAkB,QAAQ,EAAE,YAAY,CAAU;IAClD,SAAkB,IAAI,YAAY;IAEnB,OAAO,CACpB,MAAM,EAAE,mBAAmB,EAC3B,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,mBAAmB,CAAC;CAyChC"}

package/dist/steps/builtin/transform.step.js

@@ -1,135 +0,0 @@
-/**
- * TRANSFORM step — pure data manipulation.
- *
- * Applies a sequence of operations to the workflow context:
- * - set: write a value at a dotted path
- * - rename: move a value from one path to another
- * - remove: delete a value at a dotted path
- * - copy: copy a value from one path to another
- *
- * No services, no credentials — pure deterministic logic.
- */
-import { z } from 'zod';
-import { BaseActionStep } from '../base-step.js';
-import { BuiltinStepType } from '../../types/known-types.js';
-import { resolvePath } from '../../engine/variable-resolver.js';
-// ─── Config ───
-const SetOpSchema = z.object({
-    op: z.literal('set'),
-    path: z.string().min(1).describe('Dotted path where the value will be written'),
-    value: z.unknown().describe('Value to set at the path'),
-});
-const RenameOpSchema = z.object({
-    op: z.literal('rename'),
-    from: z.string().min(1).describe('Source dotted path'),
-    to: z.string().min(1).describe('Destination dotted path'),
-});
-const RemoveOpSchema = z.object({
-    op: z.literal('remove'),
-    path: z.string().min(1).describe('Dotted path to delete'),
-});
-const CopyOpSchema = z.object({
-    op: z.literal('copy'),
-    from: z.string().min(1).describe('Source dotted path'),
-    to: z.string().min(1).describe('Destination dotted path'),
-});
-export const TransformOpSchema = z.discriminatedUnion('op', [
-    SetOpSchema,
-    RenameOpSchema,
-    RemoveOpSchema,
-    CopyOpSchema,
-]);
-export const TransformStepConfigSchema = z.object({
-    operations: z.array(TransformOpSchema).min(1).describe('Sequence of data transformation operations to apply'),
-});
-const TransformStepOutputSchema = z.object({
-    applied: z.number(),
-});
-// ─── Helpers ───
-/**
- * Set a value at a dotted path on a target object.
- * Creates intermediate objects as needed.
- */
-function setAtPath(target, path, value) {
-    const parts = path.split('.');
-    let current = target;
-    for (let i = 0; i < parts.length - 1; i++) {
-        const key = parts[i];
-        if (current[key] === undefined ||
-            current[key] === null ||
-            typeof current[key] !== 'object') {
-            current[key] = {};
-        }
-        current = current[key];
-    }
-    current[parts[parts.length - 1]] = value;
-}
-/**
- * Delete a value at a dotted path.
- */
-function deleteAtPath(target, path) {
-    const parts = path.split('.');
-    let current = target;
-    for (let i = 0; i < parts.length - 1; i++) {
-        const key = parts[i];
-        if (current[key] === undefined ||
-            current[key] === null ||
-            typeof current[key] !== 'object') {
-            return false;
-        }
-        current = current[key];
-    }
-    const lastKey = parts[parts.length - 1];
-    if (lastKey in current) {
-        delete current[lastKey];
-        return true;
-    }
-    return false;
-}
-// ─── Step ───
-export class TransformStep extends BaseActionStep {
-    type = BuiltinStepType.TRANSFORM;
-    name = 'Transform';
-    description = 'Apply data transformations to the workflow context';
-    configSchema = TransformStepConfigSchema;
-    outputSchema = TransformStepOutputSchema;
-    category = 'data';
-    icon = 'filter';
-    async execute(config, ctx) {
-        let applied = 0;
-        // Operate on the steps record
-        const data = ctx.workflow.steps;
-        for (const op of config.operations) {
-            switch (op.op) {
-                case 'set':
-                    setAtPath(data, op.path, op.value);
-                    applied++;
-                    break;
-                case 'rename': {
-                    const value = resolvePath(ctx.workflow, op.from);
-                    if (value !== undefined) {
-                        setAtPath(data, op.to, value);
-                        deleteAtPath(data, op.from);
-                        applied++;
-                    }
-                    break;
-                }
-                case 'remove':
-                    if (deleteAtPath(data, op.path)) {
-                        applied++;
-                    }
-                    break;
-                case 'copy': {
-                    const val = resolvePath(ctx.workflow, op.from);
-                    if (val !== undefined) {
-                        setAtPath(data, op.to, val);
-                        applied++;
-                    }
-                    break;
-                }
-            }
-        }
-        return { applied };
-    }
-}
-//# sourceMappingURL=transform.step.js.map

package/dist/steps/builtin/transform.step.js.map

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

package/dist/types/attachment.d.ts

@@ -1,23 +0,0 @@
-/**
- * Attachment — opaque reference to a file managed by the host's StorageAdapter.
- *
- * Used everywhere the framework carries a file:
- * - Trigger inputs (uploaded via `POST /uploads`, attached to `context.trigger.attachments`)
- * - Resume payloads (uploaded with feedback in a review-gate retry)
- * - Step inputs (rerunFromStep with attachments in configOverrides)
- *
- * The framework never opens `data` — it's a host-defined reference (URL,
- * blob ID, signed token, `mem://uuid`). Steps that need the bytes call
- * `StorageAdapter.read()` via a service the host registers.
- */
-export interface Attachment {
-    /** Original filename — e.g. "contract.pdf". */
-    name: string;
-    /** MIME type — e.g. "application/pdf", "image/png". */
-    mimeType: string;
-    /** Opaque host reference. Framework treats this as a string. */
-    data: string;
-    /** Size in bytes — set by storage after upload. Useful for UI display + size budgets. */
-    size?: number;
-}
-//# sourceMappingURL=attachment.d.ts.map

package/dist/types/attachment.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../src/types/attachment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/types/attachment.js

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

package/dist/types/attachment.js.map

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

package/dist/types/resume-payload.d.ts

@@ -1,34 +0,0 @@
-/**
- * ResumePayload — the unified shape for resuming a paused execution.
- *
- * One contract for every pause type:
- * - Mid-execution agent pauses (tool approval, input required, user interrupted)
- * - Review gates (`onComplete: 'review'`)
- *
- * The router validates incoming bodies into this shape; persistence stores it
- * verbatim; the executor and step `onResume` handlers consume it.
- */
-import type { Attachment } from './attachment.js';
-/**
- * Alias for {@link Attachment} kept for clarity at call sites that historically
- * said "resume attachment". The shape is shared across the framework.
- */
-export type ResumeAttachment = Attachment;
-/**
- * What the user decided.
- * - `approve`: continue from a mid-pause OR advance past a review gate
- * - `retry`:   re-execute the current step with `priorState` + `feedback` (review gate)
- * - `abort`:   cancel the execution
- */
-export type ResumeAction = 'approve' | 'retry' | 'abort';
-/** Payload from the host when resuming a paused execution. */
-export interface ResumePayload {
-    action: ResumeAction;
-    /** User-provided text input (form feedback, instruction, additional context). */
-    feedback?: string;
-    /** Files uploaded alongside the feedback. Opaque references — host resolves. */
-    attachments?: ResumeAttachment[];
-    /** Step-specific extras from custom form fields. Opaque to the framework. */
-    data?: Record<string, unknown>;
-}
-//# sourceMappingURL=resume-payload.d.ts.map

package/dist/types/resume-payload.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resume-payload.d.ts","sourceRoot":"","sources":["../../src/types/resume-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAEzD,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC"}

package/dist/types/resume-payload.js

@@ -1,12 +0,0 @@
-/**
- * ResumePayload — the unified shape for resuming a paused execution.
- *
- * One contract for every pause type:
- * - Mid-execution agent pauses (tool approval, input required, user interrupted)
- * - Review gates (`onComplete: 'review'`)
- *
- * The router validates incoming bodies into this shape; persistence stores it
- * verbatim; the executor and step `onResume` handlers consume it.
- */
-export {};
-//# sourceMappingURL=resume-payload.js.map

package/dist/types/resume-payload.js.map

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

package/dist/util/executable-check.d.ts

@@ -1,42 +0,0 @@
-/**
- * Executable upload safety check.
- *
- * Allow-by-default with a deny-list of known dangerous types — covers the
- * common attack surface (native binaries, scripts that auto-run, installers,
- * macro-enabled Office docs) without forcing workflow authors to enumerate
- * every safe MIME type.
- *
- * Two checks run in parallel so spoofed MIME types alone can't bypass:
- *   1. MIME type matches the deny-list
- *   2. Filename extension matches the deny-list
- *
- * Either match blocks the upload. To accept executables (e.g. a security-
- * analysis workflow that intentionally examines binaries), the host opts
- * in via `RuntimeOptions.allowExecutableUploads = true`.
- */
-/**
- * MIME types treated as executable / unsafe (lowercase — input is also
- * lowercased before comparison).
- */
-export declare const BLOCKED_EXECUTABLE_MIME_TYPES: ReadonlySet<string>;
-/**
- * File extensions treated as executable / unsafe (case-insensitive, no dot).
- * The check uses the LAST extension so `report.exe.txt` is treated as text
- * (Windows shows the trailing extension, which is what the user actually sees).
- */
-export declare const BLOCKED_EXECUTABLE_EXTENSIONS: ReadonlySet<string>;
-/**
- * Extract the lowercase extension (no dot) from a filename, or '' if none.
- * A leading dot doesn't count — `.bashrc` has no extension, not "bashrc".
- */
-export declare function extensionOf(name: string): string;
-/**
- * Returns a human-readable reason if the file should be blocked as
- * executable, or `null` if it's safe.
- *
- * Always check both the MIME type and the filename — clients can spoof one
- * but rarely both. This is defense-in-depth, not authoritative malware
- * detection (run real AV at the storage layer for that).
- */
-export declare function isExecutable(mimeType: string, name: string): string | null;
-//# sourceMappingURL=executable-check.d.ts.map

package/dist/util/executable-check.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"executable-check.d.ts","sourceRoot":"","sources":["../../src/util/executable-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,WAAW,CAAC,MAAM,CAwC5D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,WAAW,CAAC,MAAM,CAmB5D,CAAC;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS1E"}

package/dist/util/executable-check.js

@@ -1,115 +0,0 @@
-/**
- * Executable upload safety check.
- *
- * Allow-by-default with a deny-list of known dangerous types — covers the
- * common attack surface (native binaries, scripts that auto-run, installers,
- * macro-enabled Office docs) without forcing workflow authors to enumerate
- * every safe MIME type.
- *
- * Two checks run in parallel so spoofed MIME types alone can't bypass:
- *   1. MIME type matches the deny-list
- *   2. Filename extension matches the deny-list
- *
- * Either match blocks the upload. To accept executables (e.g. a security-
- * analysis workflow that intentionally examines binaries), the host opts
- * in via `RuntimeOptions.allowExecutableUploads = true`.
- */
-/**
- * MIME types treated as executable / unsafe (lowercase — input is also
- * lowercased before comparison).
- */
-export const BLOCKED_EXECUTABLE_MIME_TYPES = new Set([
-    // Native binaries
-    'application/x-msdownload',
-    'application/x-msdos-program',
-    'application/x-executable',
-    'application/x-mach-binary',
-    'application/vnd.microsoft.portable-executable',
-    'application/x-msi',
-    'application/x-ms-installer',
-    // Shell + Windows scripts
-    'application/x-sh',
-    'application/x-shellscript',
-    'application/x-bat',
-    'application/x-csh',
-    'application/x-cmd',
-    'application/x-msmetafile',
-    // JavaScript / ECMAScript
-    'text/javascript',
-    'application/javascript',
-    'application/ecmascript',
-    'application/x-javascript',
-    // Java / Flash
-    'application/java-archive',
-    'application/x-java-archive',
-    'application/x-java-jnlp-file',
-    'application/x-shockwave-flash',
-    // Installer / package formats that bundle executables
-    'application/vnd.android.package-archive',
-    'application/x-debian-package',
-    'application/x-rpm',
-    // Macro-enabled Office documents (lowercased — IANA tokens are case-insensitive)
-    'application/vnd.ms-word.document.macroenabled.12',
-    'application/vnd.ms-word.template.macroenabled.12',
-    'application/vnd.ms-excel.sheet.macroenabled.12',
-    'application/vnd.ms-excel.template.macroenabled.12',
-    'application/vnd.ms-excel.addin.macroenabled.12',
-    'application/vnd.ms-excel.sheet.binary.macroenabled.12',
-    'application/vnd.ms-powerpoint.presentation.macroenabled.12',
-    'application/vnd.ms-powerpoint.template.macroenabled.12',
-    'application/vnd.ms-powerpoint.addin.macroenabled.12',
-]);
-/**
- * File extensions treated as executable / unsafe (case-insensitive, no dot).
- * The check uses the LAST extension so `report.exe.txt` is treated as text
- * (Windows shows the trailing extension, which is what the user actually sees).
- */
-export const BLOCKED_EXECUTABLE_EXTENSIONS = new Set([
-    // Windows
-    'exe', 'msi', 'com', 'scr', 'cmd', 'bat', 'ps1', 'psm1',
-    'vbs', 'vbe', 'wsf', 'wsh', 'hta', 'cpl', 'lnk',
-    'dll', 'sys', 'drv', 'ocx',
-    // macOS / Unix
-    'app', 'dmg', 'pkg',
-    'sh', 'bash', 'zsh', 'fish', 'csh', 'ksh', 'command', 'tool',
-    // Java / Flash
-    'jar', 'war', 'jnlp', 'swf',
-    // Mobile installers
-    'apk', 'ipa', 'xap',
-    // Linux installers
-    'deb', 'rpm', 'run', 'bin',
-    // JavaScript (auto-executes in browser / Node contexts)
-    'js', 'mjs', 'cjs',
-    // Macro-enabled Office
-    'docm', 'dotm', 'xlsm', 'xltm', 'xlam', 'xlsb',
-    'pptm', 'potm', 'ppam', 'ppsm', 'sldm',
-]);
-/**
- * Extract the lowercase extension (no dot) from a filename, or '' if none.
- * A leading dot doesn't count — `.bashrc` has no extension, not "bashrc".
- */
-export function extensionOf(name) {
-    const dot = name.lastIndexOf('.');
-    if (dot <= 0 || dot === name.length - 1)
-        return '';
-    return name.slice(dot + 1).toLowerCase();
-}
-/**
- * Returns a human-readable reason if the file should be blocked as
- * executable, or `null` if it's safe.
- *
- * Always check both the MIME type and the filename — clients can spoof one
- * but rarely both. This is defense-in-depth, not authoritative malware
- * detection (run real AV at the storage layer for that).
- */
-export function isExecutable(mimeType, name) {
-    if (BLOCKED_EXECUTABLE_MIME_TYPES.has(mimeType.toLowerCase())) {
-        return `Executable MIME type "${mimeType}" is not allowed.`;
-    }
-    const ext = extensionOf(name);
-    if (ext && BLOCKED_EXECUTABLE_EXTENSIONS.has(ext)) {
-        return `Files with .${ext} extension are not allowed.`;
-    }
-    return null;
-}
-//# sourceMappingURL=executable-check.js.map

package/dist/util/executable-check.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"executable-check.js","sourceRoot":"","sources":["../../src/util/executable-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwB,IAAI,GAAG,CAAC;IACxE,kBAAkB;IAClB,0BAA0B;IAC1B,6BAA6B;IAC7B,0BAA0B;IAC1B,2BAA2B;IAC3B,+CAA+C;IAC/C,mBAAmB;IACnB,4BAA4B;IAC5B,0BAA0B;IAC1B,kBAAkB;IAClB,2BAA2B;IAC3B,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,0BAA0B;IAC1B,0BAA0B;IAC1B,iBAAiB;IACjB,wBAAwB;IACxB,wBAAwB;IACxB,0BAA0B;IAC1B,eAAe;IACf,0BAA0B;IAC1B,4BAA4B;IAC5B,8BAA8B;IAC9B,+BAA+B;IAC/B,sDAAsD;IACtD,yCAAyC;IACzC,8BAA8B;IAC9B,mBAAmB;IACnB,iFAAiF;IACjF,kDAAkD;IAClD,kDAAkD;IAClD,gDAAgD;IAChD,mDAAmD;IACnD,gDAAgD;IAChD,uDAAuD;IACvD,4DAA4D;IAC5D,wDAAwD;IACxD,qDAAqD;CACtD,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwB,IAAI,GAAG,CAAC;IACxE,UAAU;IACV,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM;IACvD,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;IAC/C,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;IAC1B,eAAe;IACf,KAAK,EAAE,KAAK,EAAE,KAAK;IACnB,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM;IAC5D,eAAe;IACf,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK;IAC3B,oBAAoB;IACpB,KAAK,EAAE,KAAK,EAAE,KAAK;IACnB,mBAAmB;IACnB,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;IAC1B,wDAAwD;IACxD,IAAI,EAAE,KAAK,EAAE,KAAK;IAClB,uBAAuB;IACvB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC9C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CACvC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,IAAY;IACzD,IAAI,6BAA6B,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAC9D,OAAO,yBAAyB,QAAQ,mBAAmB,CAAC;IAC9D,CAAC;IACD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,GAAG,IAAI,6BAA6B,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,eAAe,GAAG,6BAA6B,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}