@gorgo/medusa-integration 0.0.1

package/.medusa/server/src/modules/integration/descriptor/__tests__/introspect.unit.spec.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const introspect_1 = require("../introspect");
+const define_1 = require("../define");
+const base = (0, define_1.defineIntegration)({
+    module: "payment",
+    displayName: "demo.name",
+    options: {
+        login: { type: "string", required: true, minLength: 1, control: "text", label: "demo.fields.login" },
+        password: { type: "string", required: true, minLength: 1, secret: true, control: "secret", label: "demo.fields.password" },
+        test_mode: { type: "boolean", default: false, control: "switch", label: "demo.fields.test_mode" },
+        region: {
+            type: "enum",
+            values: ["eu", "us"],
+            valueLabels: { eu: "demo.region.eu", us: "demo.region.us" },
+            control: "select",
+            label: "demo.fields.region",
+            visibleWhen: { field: "test_mode", equals: true },
+        },
+        webhooks: { type: "json", default: [], control: "json", label: "demo.fields.webhooks" },
+        secretToken: { type: "string", secret: true, label: "demo.fields.secretToken" },
+    },
+    sections: [
+        { id: "general", title: "demo.sections.general", options: ["login", "password"] },
+        { id: "behavior", title: "demo.sections.behavior", options: ["test_mode", "region", "webhooks"] },
+    ],
+});
+const descriptor = { ...base, pluginId: "demo", instanceId: null };
+(0, globals_1.describe)("introspect", () => {
+    (0, globals_1.it)("groups referenced options by section, omits catalog-only options", () => {
+        const ui = (0, introspect_1.introspectDescriptor)(descriptor);
+        (0, globals_1.expect)(ui.sections.map((s) => s.id)).toEqual(["general", "behavior"]);
+        (0, globals_1.expect)(ui.sections[1].fields.map((f) => f.name)).toEqual(["test_mode", "region", "webhooks"]);
+        (0, globals_1.expect)(ui.sections.flatMap((s) => s.fields.map((f) => f.name))).not.toContain("secretToken");
+    });
+    (0, globals_1.it)("required vs optional derived from the def (default/required, no zod)", () => {
+        const ui = (0, introspect_1.introspectDescriptor)(descriptor);
+        (0, globals_1.expect)(ui.sections[0].fields.find((f) => f.name === "login").required).toBe(true);
+        (0, globals_1.expect)(ui.sections[1].fields.find((f) => f.name === "test_mode").required).toBe(false); // has default
+    });
+    (0, globals_1.it)("surfaces control, enum options + labels, visibleWhen, json control", () => {
+        const ui = (0, introspect_1.introspectDescriptor)(descriptor);
+        const region = ui.sections[1].fields.find((f) => f.name === "region");
+        (0, globals_1.expect)(region.control).toBe("select");
+        (0, globals_1.expect)(region.options).toEqual(["eu", "us"]);
+        (0, globals_1.expect)(region.optionLabels).toEqual({ eu: "demo.region.eu", us: "demo.region.us" });
+        (0, globals_1.expect)(region.visibleWhen).toEqual({ field: "test_mode", equals: true });
+        (0, globals_1.expect)(ui.sections[1].fields.find((f) => f.name === "webhooks").control).toBe("json");
+    });
+    (0, globals_1.it)("lists every secret option name (including catalog-only)", () => {
+        (0, globals_1.expect)((0, introspect_1.secretFieldNames)(descriptor).sort()).toEqual(["password", "secretToken"]);
+    });
+    (0, globals_1.it)("is JSON-serializable (no functions/zod refs)", () => {
+        (0, globals_1.expect)(() => JSON.stringify((0, introspect_1.introspectDescriptor)(descriptor))).not.toThrow();
+    });
+});
+(0, globals_1.describe)("introspect readonly", () => {
+    const base = (0, define_1.defineIntegration)({
+        module: "payment",
+        displayName: "demo.name",
+        options: {
+            endpoint: {
+                type: "url",
+                readonly: true,
+                default: "https://api.example.com/hook",
+                control: "url",
+                label: "demo.fields.endpoint",
+            },
+            apiSecret: {
+                type: "string",
+                readonly: true,
+                secret: true,
+                default: "shh",
+                label: "demo.fields.apiSecret",
+            },
+        },
+        sections: [{ id: "s", title: "t", options: ["endpoint", "apiSecret"] }],
+    });
+    const roDescriptor = { ...base, pluginId: "demo", instanceId: null };
+    (0, globals_1.it)("surfaces readonly + readonlyValue (the default) for a non-secret constant", () => {
+        const f = (0, introspect_1.introspectDescriptor)(roDescriptor).sections[0].fields.find((x) => x.name === "endpoint");
+        (0, globals_1.expect)(f.readonly).toBe(true);
+        (0, globals_1.expect)(f.readonlyValue).toBe("https://api.example.com/hook");
+    });
+    (0, globals_1.it)("never exposes a secret readonly option's default", () => {
+        const f = (0, introspect_1.introspectDescriptor)(roDescriptor).sections[0].fields.find((x) => x.name === "apiSecret");
+        (0, globals_1.expect)(f.readonly).toBe(true);
+        (0, globals_1.expect)(f.secret).toBe(true);
+        (0, globals_1.expect)(f.readonlyValue).toBeUndefined();
+    });
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50cm9zcGVjdC51bml0LnNwZWMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvbW9kdWxlcy9pbnRlZ3JhdGlvbi9kZXNjcmlwdG9yL19fdGVzdHNfXy9pbnRyb3NwZWN0LnVuaXQuc3BlYy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLDJDQUFvRDtBQUNwRCw4Q0FBc0U7QUFDdEUsc0NBQTZDO0FBRzdDLE1BQU0sSUFBSSxHQUFHLElBQUEsMEJBQWlCLEVBQUM7SUFDN0IsTUFBTSxFQUFFLFNBQVM7SUFDakIsV0FBVyxFQUFFLFdBQVc7SUFDeEIsT0FBTyxFQUFFO1FBQ1AsS0FBSyxFQUFFLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxRQUFRLEVBQUUsSUFBSSxFQUFFLFNBQVMsRUFBRSxDQUFDLEVBQUUsT0FBTyxFQUFFLE1BQU0sRUFBRSxLQUFLLEVBQUUsbUJBQW1CLEVBQUU7UUFDcEcsUUFBUSxFQUFFLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxRQUFRLEVBQUUsSUFBSSxFQUFFLFNBQVMsRUFBRSxDQUFDLEVBQUUsTUFBTSxFQUFFLElBQUksRUFBRSxPQUFPLEVBQUUsUUFBUSxFQUFFLEtBQUssRUFBRSxzQkFBc0IsRUFBRTtRQUMxSCxTQUFTLEVBQUUsRUFBRSxJQUFJLEVBQUUsU0FBUyxFQUFFLE9BQU8sRUFBRSxLQUFLLEVBQUUsT0FBTyxFQUFFLFFBQVEsRUFBRSxLQUFLLEVBQUUsdUJBQXVCLEVBQUU7UUFDakcsTUFBTSxFQUFFO1lBQ04sSUFBSSxFQUFFLE1BQU07WUFDWixNQUFNLEVBQUUsQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDO1lBQ3BCLFdBQVcsRUFBRSxFQUFFLEVBQUUsRUFBRSxnQkFBZ0IsRUFBRSxFQUFFLEVBQUUsZ0JBQWdCLEVBQUU7WUFDM0QsT0FBTyxFQUFFLFFBQVE7WUFDakIsS0FBSyxFQUFFLG9CQUFvQjtZQUMzQixXQUFXLEVBQUUsRUFBRSxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sRUFBRSxJQUFJLEVBQUU7U0FDbEQ7UUFDRCxRQUFRLEVBQUUsRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFFLE9BQU8sRUFBRSxFQUFFLEVBQUUsT0FBTyxFQUFFLE1BQU0sRUFBRSxLQUFLLEVBQUUsc0JBQXNCLEVBQUU7UUFDdkYsV0FBVyxFQUFFLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxNQUFNLEVBQUUsSUFBSSxFQUFFLEtBQUssRUFBRSx5QkFBeUIsRUFBRTtLQUNoRjtJQUNELFFBQVEsRUFBRTtRQUNSLEVBQUUsRUFBRSxFQUFFLFNBQVMsRUFBRSxLQUFLLEVBQUUsdUJBQXVCLEVBQUUsT0FBTyxFQUFFLENBQUMsT0FBTyxFQUFFLFVBQVUsQ0FBQyxFQUFFO1FBQ2pGLEVBQUUsRUFBRSxFQUFFLFVBQVUsRUFBRSxLQUFLLEVBQUUsd0JBQXdCLEVBQUUsT0FBTyxFQUFFLENBQUMsV0FBVyxFQUFFLFFBQVEsRUFBRSxVQUFVLENBQUMsRUFBRTtLQUNsRztDQUNGLENBQUMsQ0FBQTtBQUNGLE1BQU0sVUFBVSxHQUEwQixFQUFFLEdBQUcsSUFBSSxFQUFFLFFBQVEsRUFBRSxNQUFNLEVBQUUsVUFBVSxFQUFFLElBQUksRUFBRSxDQUFBO0FBRXpGLElBQUEsa0JBQVEsRUFBQyxZQUFZLEVBQUUsR0FBRyxFQUFFO0lBQzFCLElBQUEsWUFBRSxFQUFDLGtFQUFrRSxFQUFFLEdBQUcsRUFBRTtRQUMxRSxNQUFNLEVBQUUsR0FBRyxJQUFBLGlDQUFvQixFQUFDLFVBQVUsQ0FBQyxDQUFBO1FBQzNDLElBQUEsZ0JBQU0sRUFBQyxFQUFFLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLENBQUMsU0FBUyxFQUFFLFVBQVUsQ0FBQyxDQUFDLENBQUE7UUFDckUsSUFBQSxnQkFBTSxFQUFDLEVBQUUsQ0FBQyxRQUFRLENBQUMsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLENBQUMsV0FBVyxFQUFFLFFBQVEsRUFBRSxVQUFVLENBQUMsQ0FBQyxDQUFBO1FBQzdGLElBQUEsZ0JBQU0sRUFBQyxFQUFFLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQyxhQUFhLENBQUMsQ0FBQTtJQUM5RixDQUFDLENBQUMsQ0FBQTtJQUVGLElBQUEsWUFBRSxFQUFDLHNFQUFzRSxFQUFFLEdBQUcsRUFBRTtRQUM5RSxNQUFNLEVBQUUsR0FBRyxJQUFBLGlDQUFvQixFQUFDLFVBQVUsQ0FBQyxDQUFBO1FBQzNDLElBQUEsZ0JBQU0sRUFBQyxFQUFFLENBQUMsUUFBUSxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLEtBQUssT0FBTyxDQUFFLENBQUMsUUFBUSxDQUFDLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFBO1FBQ2xGLElBQUEsZ0JBQU0sRUFBQyxFQUFFLENBQUMsUUFBUSxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLEtBQUssV0FBVyxDQUFFLENBQUMsUUFBUSxDQUFDLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFBLENBQUMsY0FBYztJQUN4RyxDQUFDLENBQUMsQ0FBQTtJQUVGLElBQUEsWUFBRSxFQUFDLG9FQUFvRSxFQUFFLEdBQUcsRUFBRTtRQUM1RSxNQUFNLEVBQUUsR0FBRyxJQUFB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

package/.medusa/server/src/modules/integration/descriptor/__tests__/validate.unit.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/.medusa/server/src/modules/integration/descriptor/__tests__/validate.unit.spec.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const define_1 = require("../define");
+const validate_1 = require("../validate");
+const requiredWhenCapture = (v, c) => {
+    if (c.options.capture && (v == null || v === ""))
+        c.addIssue({ message: "required when capture is on" });
+};
+const base = (0, define_1.defineIntegration)({
+    module: "payment",
+    displayName: "demo.name",
+    options: {
+        terminalKey: { type: "string", required: true, minLength: 1, label: "l" },
+        password: { type: "string", required: true, minLength: 1, secret: true, label: "l" },
+        capture: { type: "boolean", default: true, label: "l" },
+        // per-option cross-field rule (references a sibling)
+        fallbackKey: { type: "string", label: "l", validate: requiredWhenCapture },
+    },
+    sections: [
+        { id: "credentials", title: "t", options: ["terminalKey", "password"] },
+        { id: "behavior", title: "t", options: ["capture", "fallbackKey"] },
+    ],
+    // cross-section rule (spans credentials + behavior)
+    validate: (full, ctx) => {
+        if (full.capture && !full.terminalKey)
+            ctx.addIssue({ path: ["terminalKey"], message: "terminalKey required when capture is on" });
+    },
+});
+const descriptor = { ...base, pluginId: "demo", instanceId: null };
+(0, globals_1.describe)("validateOptions", () => {
+    (0, globals_1.it)("validates only the submitted ids and applies their defaults", () => {
+        const res = (0, validate_1.validateOptions)(descriptor, ["capture"], { capture: undefined });
+        (0, globals_1.expect)(res.success).toBe(true);
+        if (res.success)
+            (0, globals_1.expect)(res.data.capture).toBe(true);
+    });
+    (0, globals_1.it)("reports zod issues for a submitted id", () => {
+        const res = (0, validate_1.validateOptions)(descriptor, ["terminalKey"], { terminalKey: "" });
+        (0, globals_1.expect)(res.success).toBe(false);
+        if (!res.success)
+            (0, globals_1.expect)(res.issues.map((i) => i.path)).toContain("terminalKey");
+    });
+    (0, globals_1.it)("runs a per-option validate against the merged siblings", () => {
+        // fallbackKey blank + capture true → per-option rule fires
+        const res = (0, validate_1.validateOptions)(descriptor, ["fallbackKey"], { fallbackKey: "", capture: true });
+        (0, globals_1.expect)(res.success).toBe(false);
+        if (!res.success)
+            (0, globals_1.expect)(res.issues.map((i) => i.path)).toContain("fallbackKey");
+    });
+});
+(0, globals_1.describe)("isDescriptorComplete / collectValidationIssues", () => {
+    (0, globals_1.it)("is incomplete when a required field (any option) is missing", () => {
+        (0, globals_1.expect)((0, validate_1.isDescriptorComplete)(descriptor, { terminalKey: "t" })).toBe(false); // password + fallbackKey rule
+    });
+    (0, globals_1.it)("is complete when all required present, defaults fill the rest, and rules pass", () => {
+        (0, globals_1.expect)((0, validate_1.isDescriptorComplete)(descriptor, { terminalKey: "t", password: "p", fallbackKey: "f" })).toBe(true);
+    });
+    (0, globals_1.it)("runs the cross-section validate rule", () => {
+        const issues = (0, validate_1.collectValidationIssues)(descriptor, { password: "p", capture: true, fallbackKey: "f" });
+        (0, globals_1.expect)(issues.some((i) => i.path === "terminalKey")).toBe(true);
+    });
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGUudW5pdC5zcGVjLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vLi4vc3JjL21vZHVsZXMvaW50ZWdyYXRpb24vZGVzY3JpcHRvci9fX3Rlc3RzX18vdmFsaWRhdGUudW5pdC5zcGVjLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQUEsMkNBQW9EO0FBQ3BELHNDQUE2QztBQUU3QywwQ0FBNEY7QUFFNUYsTUFBTSxtQkFBbUIsR0FBRyxDQUFDLENBQVUsRUFBRSxDQUFNLEVBQUUsRUFBRTtJQUNqRCxJQUFJLENBQUMsQ0FBQyxPQUFPLENBQUMsT0FBTyxJQUFJLENBQUMsQ0FBQyxJQUFJLElBQUksSUFBSSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQUUsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxFQUFFLE9BQU8sRUFBRSw2QkFBNkIsRUFBRSxDQUFDLENBQUE7QUFDMUcsQ0FBQyxDQUFBO0FBRUQsTUFBTSxJQUFJLEdBQUcsSUFBQSwwQkFBaUIsRUFBQztJQUM3QixNQUFNLEVBQUUsU0FBUztJQUNqQixXQUFXLEVBQUUsV0FBVztJQUN4QixPQUFPLEVBQUU7UUFDUCxXQUFXLEVBQUUsRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFLFFBQVEsRUFBRSxJQUFJLEVBQUUsU0FBUyxFQUFFLENBQUMsRUFBRSxLQUFLLEVBQUUsR0FBRyxFQUFFO1FBQ3pFLFFBQVEsRUFBRSxFQUFFLElBQUksRUFBRSxRQUFRLEVBQUUsUUFBUSxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsQ0FBQyxFQUFFLE1BQU0sRUFBRSxJQUFJLEVBQUUsS0FBSyxFQUFFLEdBQUcsRUFBRTtRQUNwRixPQUFPLEVBQUUsRUFBRSxJQUFJLEVBQUUsU0FBUyxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsS0FBSyxFQUFFLEdBQUcsRUFBRTtRQUN2RCxxREFBcUQ7UUFDckQsV0FBVyxFQUFFLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxLQUFLLEVB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

package/.medusa/server/src/modules/integration/descriptor/build-zod.d.ts

@@ -0,0 +1,8 @@
+import { z } from "@medusajs/deps/zod";
+import type { OptionDef } from "./option";
+/**
+ * Build a zod schema for one option from our declarative properties. Presence: an option is
+ * OPTIONAL unless `required: true`; a `default` makes it always-present (and satisfies required).
+ * `json` is opaque (`z.unknown()`) — its shape is checked by the option's imperative `validate`.
+ */
+export declare function optionToZod(def: OptionDef): z.ZodType;

package/.medusa/server/src/modules/integration/descriptor/build-zod.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.optionToZod = optionToZod;
+const zod_1 = require("@medusajs/deps/zod");
+/**
+ * Build a zod schema for one option from our declarative properties. Presence: an option is
+ * OPTIONAL unless `required: true`; a `default` makes it always-present (and satisfies required).
+ * `json` is opaque (`z.unknown()`) — its shape is checked by the option's imperative `validate`.
+ */
+function optionToZod(def) {
+    let base;
+    switch (def.type) {
+        case "string": {
+            let s = zod_1.z.string();
+            if (def.minLength != null)
+                s = s.min(def.minLength);
+            if (def.maxLength != null)
+                s = s.max(def.maxLength);
+            if (def.pattern != null)
+                s = s.regex(new RegExp(def.pattern));
+            base = s;
+            break;
+        }
+        case "url": {
+            // Restrict the scheme when `protocols` is given (e.g. ["https"] → protocol /^(?:https)$/).
+            const protocol = def.protocols && def.protocols.length > 0
+                ? new RegExp(`^(?:${def.protocols.join("|")})$`)
+                : undefined;
+            base = protocol ? zod_1.z.url({ protocol }) : zod_1.z.url();
+            break;
+        }
+        case "email": {
+            base = zod_1.z.email();
+            break;
+        }
+        case "uuid": {
+            base = zod_1.z.uuid();
+            break;
+        }
+        case "number": {
+            let n = zod_1.z.number();
+            if (def.int)
+                n = n.int();
+            if (def.positive)
+                n = n.positive();
+            if (def.nonnegative)
+                n = n.nonnegative();
+            if (def.multipleOf != null)
+                n = n.multipleOf(def.multipleOf);
+            if (def.min != null)
+                n = n.min(def.min);
+            if (def.max != null)
+                n = n.max(def.max);
+            base = n;
+            break;
+        }
+        case "boolean":
+            base = zod_1.z.boolean();
+            break;
+        case "enum":
+            base = zod_1.z.enum(def.values);
+            break;
+        case "json": {
+            // Opaque JSON; presence handled here (z.unknown() otherwise accepts undefined).
+            if (def.default !== undefined)
+                return zod_1.z.unknown().default(def.default);
+            if (def.required)
+                return zod_1.z.unknown().refine((v) => v !== undefined, { message: "Required" });
+            return zod_1.z.unknown().optional();
+        }
+        default: {
+            const _never = def;
+            throw new Error(`Unsupported option type: ${JSON.stringify(_never)}`);
+        }
+    }
+    if (def.default !== undefined)
+        return base.default(def.default);
+    if (!def.required)
+        return base.optional();
+    return base;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVpbGQtem9kLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL21vZHVsZXMvaW50ZWdyYXRpb24vZGVzY3JpcHRvci9idWlsZC16b2QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFRQSxrQ0E0REM7QUFwRUQsNENBQXNDO0FBR3RDOzs7O0dBSUc7QUFDSCxTQUFnQixXQUFXLENBQUMsR0FBYztJQUN4QyxJQUFJLElBQWUsQ0FBQTtJQUNuQixRQUFRLEdBQUcsQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUNqQixLQUFLLFFBQVEsQ0FBQyxDQUFDLENBQUM7WUFDZCxJQUFJLENBQUMsR0FBRyxPQUFDLENBQUMsTUFBTSxFQUFFLENBQUE7WUFDbEIsSUFBSSxHQUFHLENBQUMsU0FBUyxJQUFJLElBQUk7Z0JBQUUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQyxDQUFBO1lBQ25ELElBQUksR0FBRyxDQUFDLFNBQVMsSUFBSSxJQUFJO2dCQUFFLENBQUMsR0FBRyxDQUFDLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxTQUFTLENBQUMsQ0FBQTtZQUNuRCxJQUFJLEdBQUcsQ0FBQyxPQUFPLElBQUksSUFBSTtnQkFBRSxDQUFDLEdBQUcsQ0FBQyxDQUFDLEtBQUssQ0FBQyxJQUFJLE1BQU0sQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQTtZQUM3RCxJQUFJLEdBQUcsQ0FBQyxDQUFBO1lBQ1IsTUFBSztRQUNQLENBQUM7UUFDRCxLQUFLLEtBQUssQ0FBQyxDQUFDLENBQUM7WUFDWCwyRkFBMkY7WUFDM0YsTUFBTSxRQUFRLEdBQ1osR0FBRyxDQUFDLFNBQVMsSUFBSSxHQUFHLENBQUMsU0FBUyxDQUFDLE1BQU0sR0FBRyxDQUFDO2dCQUN2QyxDQUFDLENBQUMsSUFBSSxNQUFNLENBQUMsT0FBTyxHQUFHLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDO2dCQUNoRCxDQUFDLENBQUMsU0FBUyxDQUFBO1lBQ2YsSUFBSSxHQUFHLFFBQVEsQ0FBQyxDQUFDLENBQUMsT0FBQyxDQUFDLEdBQUcsQ0FBQyxFQUFFLFFBQVEsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLE9BQUMsQ0FBQyxHQUFHLEVBQUUsQ0FBQTtZQUMvQyxNQUFLO1FBQ1AsQ0FBQztRQUNELEtBQUssT0FBTyxDQUFDLENBQUMsQ0FBQztZQUNiLElBQUksR0FBRyxPQUFDLENBQUMsS0FBSyxFQUFFLENBQUE7WUFDaEIsTUFBSztRQUNQLENBQUM7UUFDRCxLQUFLLE1BQU0sQ0FBQyxDQUFDLENBQUM7WUFDWixJQUFJLEdBQUcsT0FBQyxDQUFDLElBQUksRUFBRSxDQUFBO1lBQ2YsTUFBSztRQUNQLENBQUM7UUFDRCxLQUFLLFFBQVEsQ0FBQyxDQUFDLENBQUM7WUFDZCxJQUFJLENBQUMsR0FBRyxPQUFDLENBQUMsTUFBTSxFQUFFLENBQUE7WUFDbEIsSUFBSSxHQUFHLENBQUMsR0FBRztnQkFBRSxDQUFDLEdBQUcsQ0FBQyxDQUFDLEdBQUcsRUFBRSxDQUFBO1lBQ3hCLElBQUksR0FBRyxDQUFDLFFBQVE7Z0JBQUUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxRQUFRLEVBQUUsQ0FBQTtZQUNsQyxJQUFJLEdBQUcsQ0FBQyxXQUFXO2dCQUFFLENBQUMsR0FBRyxDQUFDLENBQUMsV0FBVyxFQUFFLENBQUE7WUFDeEMsSUFBSSxHQUFHLENBQUMsVUFBVSxJQUFJLElBQUk7Z0JBQUUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLFVBQVUsQ0FBQyxDQUFBO1lBQzVELElBQUksR0FBRyxDQUFDLEdBQUcsSUFBSSxJQUFJO2dCQUFFLENBQUMsR0FBRyxDQUFDLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQTtZQUN2QyxJQUFJLEdBQUcsQ0FBQyxHQUFHLElBQUksSUFBSTtnQkFBRSxDQUFDLEdBQUcsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUE7WUFDdkMsSUFBSSxHQUFHLENBQUMsQ0FBQTtZQUNSLE1BQUs7UUFDUCxDQUFDO1FBQ0QsS0FBSyxTQUFTO1lBQ1osSUFBSSxHQUFHLE9BQUMsQ0FBQyxPQUFPLEVBQUUsQ0FBQTtZQUNsQixNQUFLO1FBQ1AsS0FBSyxNQUFNO1lBQ1QsSUFBSSxHQUFHLE9BQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQStCLENBQUMsQ0FBQTtZQUNsRCxNQUFLO1FBQ1AsS0FBSyxNQUFNLENBQUMsQ0FBQyxDQUFDO1lBQ1osZ0ZBQWdGO1lBQ2hGLElBQUksR0FBRyxDQUFDLE9BQU8sS0FBSyxTQUFTO2dCQUFFLE9BQU8sT0FBQyxDQUFDLE9BQU8sRUFBRSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsT0FBZ0IsQ0FBQyxDQUFBO1lBQy9FLElBQUksR0FBRyxDQUFDLFFBQVE7Z0JBQUUsT0FBTyxPQUFDLENBQUMsT0FBTyxFQUFFLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLEtBQUssU0FBUyxFQUFFLEVBQUUsT0FBTyxFQUFFLFVBQVUsRUFBRSxDQUFDLENBQUE7WUFDNUYsT0FBTyxPQUFDLENBQUMsT0FBTyxFQUFFLENBQUMsUUFBUSxFQUFFLENBQUE7UUFDL0IsQ0FBQztRQUNELE9BQU8sQ0FBQyxDQUFDLENBQUM7WUFDUixNQUFNLE1BQU0sR0FBVSxHQUFHLENBQUE7WUFDekIsTUFBTSxJQUFJLEtBQUssQ0FBQyw0QkFBNEIsSUFBSSxDQUFDLFNBQVMsQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDLENBQUE7UUFDdkUsQ0FBQztJQUNILENBQUM7SUFFRCxJQUFJLEdBQUcsQ0FBQyxPQUFPLEtBQUssU0FBUztRQUFFLE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsT0FBZ0IsQ0FBQyxDQUFBO0lBQ3hFLElBQUksQ0FBQyxHQUFHLENBQUMsUUFBUTtRQUFFLE9BQU8sSUFBSSxDQUFDLFFBQVEsRUFBRSxDQUFBO0lBQ3pDLE9BQU8sSUFBSSxDQUFBO0FBQ2IsQ0FBQyJ9

package/.medusa/server/src/modules/integration/descriptor/define.d.ts

@@ -0,0 +1,74 @@
+import { z } from "@medusajs/deps/zod";
+import type { I18nKey } from "./meta";
+import type { OptionDef, Settings } from "./option";
+import type { IntegrationLayouts, ModuleKind, TestConnectionContext, TestConnectionResult } from "../../../types";
+export { z };
+export type { ModuleKind, TestConnectionContext, TestConnectionResult };
+export type { OptionDef, OptionValidateContext, OptionValue, Settings } from "./option";
+/** One configuration section — references options by id from the descriptor's catalog. */
+export type IntegrationSection = {
+    id: string;
+    /** i18n key for the section title (resolved admin-side). */
+    title: I18nKey;
+    /** Ordered option ids drawn into this section's auto-generated card/drawer. */
+    options: readonly string[];
+    /** Which column to render this section in (two-column layout). Defaults to `"main"`. */
+    column?: "main" | "side";
+};
+/** Issue raised by the cross-section `validate` rule. */
+export type IntegrationValidateIssue = {
+    path?: (string | number)[];
+    message: string;
+};
+export type IntegrationValidateContext = {
+    addIssue: (issue: IntegrationValidateIssue) => void;
+};
+type DescriptorBase = {
+    /** Which Medusa module this integration configures (payment, fulfillment, …). */
+    module: ModuleKind;
+    optionsVersion?: number;
+    displayName: I18nKey;
+    description?: I18nKey;
+    icon?: string;
+    docsUrl?: string;
+    supportsMultipleInstances?: boolean;
+    preferredLayoutId?: IntegrationLayouts;
+};
+type CrossSectionRules = {
+    /**
+     * Rules that span MORE THAN ONE section. Evaluated only during full (activation)
+     * validation, against the assembled config. Intra-option rules belong on that option's
+     * own `validate` so they also run when the option is saved.
+     */
+    validate?: (full: Record<string, unknown>, ctx: IntegrationValidateContext) => void;
+};
+/** What `defineIntegration` returns (and what a provider's `getDescriptor()` returns). */
+export type IntegrationDescriptorInput = DescriptorBase & CrossSectionRules & {
+    /** Flat catalog: single source of truth for every option (type/validation/UI/secret). */
+    options: Record<string, OptionDef>;
+    /** Composed from `options` by `defineIntegration` — for `z.infer`, defaults, full validation. */
+    optionsSchema: z.ZodType<any>;
+    sections: readonly IntegrationSection[];
+};
+export type IntegrationDescriptor = IntegrationDescriptorInput & {
+    /** Stamped by the registry from the provider's `static identifier`. */
+    pluginId: string;
+    /** Stamped from the registration id (null = single/default instance). */
+    instanceId?: string | null;
+};
+/**
+ * Declare an integration's configuration as a flat option catalog plus sections that
+ * reference option ids. The composed `optionsSchema` (for `z.infer` + defaults + full
+ * validation) is built automatically:
+ *
+ *   const descriptor = defineIntegration({ module, displayName, options: {...}, sections: [...] })
+ *   type Settings = z.infer<typeof descriptor.optionsSchema>
+ */
+export declare function defineIntegration<const O extends Record<string, OptionDef>>(input: DescriptorBase & CrossSectionRules & {
+    options: O;
+    sections: readonly IntegrationSection[];
+}): DescriptorBase & CrossSectionRules & {
+    options: O;
+    optionsSchema: z.ZodType<Settings<O>>;
+    sections: readonly IntegrationSection[];
+};

package/.medusa/server/src/modules/integration/descriptor/define.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.z = void 0;
+exports.defineIntegration = defineIntegration;
+const zod_1 = require("@medusajs/deps/zod");
+Object.defineProperty(exports, "z", { enumerable: true, get: function () { return zod_1.z; } });
+const build_zod_1 = require("./build-zod");
+/**
+ * Declare an integration's configuration as a flat option catalog plus sections that
+ * reference option ids. The composed `optionsSchema` (for `z.infer` + defaults + full
+ * validation) is built automatically:
+ *
+ *   const descriptor = defineIntegration({ module, displayName, options: {...}, sections: [...] })
+ *   type Settings = z.infer<typeof descriptor.optionsSchema>
+ */
+function defineIntegration(input) {
+    // Fail fast: every section option id must exist in the catalog.
+    for (const section of input.sections) {
+        for (const id of section.options) {
+            if (!Object.prototype.hasOwnProperty.call(input.options, id)) {
+                throw new Error(`Section "${section.id}" references unknown option "${id}"`);
+            }
+        }
+    }
+    const shape = {};
+    for (const [id, def] of Object.entries(input.options))
+        shape[id] = (0, build_zod_1.optionToZod)(def);
+    const optionsSchema = zod_1.z.object(shape);
+    return { ...input, optionsSchema };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVmaW5lLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL21vZHVsZXMvaW50ZWdyYXRpb24vZGVzY3JpcHRvci9kZWZpbmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBdUVBLDhDQXFCQztBQTVGRCw0Q0FBc0M7QUFNN0Isa0ZBTkEsT0FBQyxPQU1BO0FBSFYsMkNBQXlDO0FBNER6Qzs7Ozs7OztHQU9HO0FBQ0gsU0FBZ0IsaUJBQWlCLENBQy9CLEtBQzZFO0lBTzdFLGdFQUFnRTtJQUNoRSxLQUFLLE1BQU0sT0FBTyxJQUFJLEtBQUssQ0FBQyxRQUFRLEVBQUUsQ0FBQztRQUNyQyxLQUFLLE1BQU0sRUFBRSxJQUFJLE9BQU8sQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUNqQyxJQUFJLENBQUMsTUFBTSxDQUFDLFNBQVMsQ0FBQyxjQUFjLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUFDLEVBQUUsQ0FBQztnQkFDN0QsTUFBTSxJQUFJLEtBQUssQ0FBQyxZQUFZLE9BQU8sQ0FBQyxFQUFFLGdDQUFnQyxFQUFFLEdBQUcsQ0FBQyxDQUFBO1lBQzlFLENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztJQUNELE1BQU0sS0FBSyxHQUE4QixFQUFFLENBQUE7SUFDM0MsS0FBSyxNQUFNLENBQUMsRUFBRSxFQUFFLEdBQUcsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQztRQUFFLEtBQUssQ0FBQyxFQUFFLENBQUMsR0FBRyxJQUFBLHVCQUFXLEVBQUMsR0FBRyxDQUFDLENBQUE7SUFDbkYsTUFBTSxhQUFhLEdBQUcsT0FBQyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQXNDLENBQUE7SUFDMUUsT0FBTyxFQUFFLEdBQUcsS0FBSyxFQUFFLGFBQWEsRUFBRSxDQUFBO0FBQ3BDLENBQUMifQ==

package/.medusa/server/src/modules/integration/descriptor/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./define";
+export * from "./option";
+export * from "./build-zod";
+export * from "./introspect";
+export * from "./meta";

package/.medusa/server/src/modules/integration/descriptor/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./define"), exports);
+__exportStar(require("./option"), exports);
+__exportStar(require("./build-zod"), exports);
+__exportStar(require("./introspect"), exports);
+__exportStar(require("./meta"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi9zcmMvbW9kdWxlcy9pbnRlZ3JhdGlvbi9kZXNjcmlwdG9yL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSwyQ0FBd0I7QUFDeEIsMkNBQXdCO0FBQ3hCLDhDQUEyQjtBQUMzQiwrQ0FBNEI7QUFDNUIseUNBQXNCIn0=

package/.medusa/server/src/modules/integration/descriptor/introspect.d.ts

@@ -0,0 +1,5 @@
+import type { IntegrationDescriptor } from "./define";
+import type { UiField, UiSection, UiDescriptor } from "../../../types";
+export type { UiField, UiSection, UiDescriptor };
+export declare function secretFieldNames(descriptor: Pick<IntegrationDescriptor, "options">): string[];
+export declare function introspectDescriptor(descriptor: IntegrationDescriptor, hasTestConnection?: boolean): UiDescriptor;

package/.medusa/server/src/modules/integration/descriptor/introspect.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.secretFieldNames = secretFieldNames;
+exports.introspectDescriptor = introspectDescriptor;
+function controlFor(def) {
+    if (def.control)
+        return def.control;
+    switch (def.type) {
+        case "boolean": return "switch";
+        case "number": return "number";
+        case "enum": return "select";
+        case "json": return "json";
+        case "url": return "url";
+        default: return "text";
+    }
+}
+function introspectField(name, def) {
+    return {
+        name,
+        control: controlFor(def),
+        secret: def.secret === true,
+        // UI-required: must be filled by the user (a `default` or an absent `required` → not required).
+        required: def.required === true && def.default === undefined,
+        label: def.label,
+        hint: def.hint,
+        placeholder: def.placeholder,
+        options: def.type === "enum" ? [...def.values] : undefined,
+        optionLabels: def.type === "enum" ? def.valueLabels : undefined,
+        visibleWhen: def.visibleWhen,
+        readonly: def.readonly,
+        // The constant to display; never expose a secret's default to the client.
+        readonlyValue: def.readonly && def.secret !== true ? def.default : undefined,
+    };
+}
+function introspectSection(section, options) {
+    return {
+        id: section.id,
+        title: section.title,
+        column: section.column ?? "main",
+        // Ignore ids missing from the options catalog (defineIntegration already rejects those at build).
+        fields: section.options
+            .filter((id) => Object.prototype.hasOwnProperty.call(options, id))
+            .map((id) => introspectField(id, options[id])),
+    };
+}
+function secretFieldNames(descriptor) {
+    return Object.entries(descriptor.options)
+        .filter(([, def]) => def.secret === true)
+        .map(([name]) => name);
+}
+function introspectDescriptor(descriptor, hasTestConnection = false) {
+    return {
+        module: descriptor.module,
+        pluginId: descriptor.pluginId,
+        instanceId: descriptor.instanceId ?? null,
+        optionsVersion: descriptor.optionsVersion ?? 1,
+        displayName: descriptor.displayName,
+        description: descriptor.description,
+        icon: descriptor.icon,
+        docsUrl: descriptor.docsUrl,
+        supportsMultipleInstances: descriptor.supportsMultipleInstances ?? false,
+        preferredLayoutId: descriptor.preferredLayoutId ?? "core:single-column",
+        hasTestConnection,
+        sections: descriptor.sections.map((s) => introspectSection(s, descriptor.options)),
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50cm9zcGVjdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3NyYy9tb2R1bGVzL2ludGVncmF0aW9uL2Rlc2NyaXB0b3IvaW50cm9zcGVjdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQW1EQSw0Q0FJQztBQUVELG9EQWtCQztBQW5FRCxTQUFTLFVBQVUsQ0FBQyxHQUFjO0lBQ2hDLElBQUksR0FBRyxDQUFDLE9BQU87UUFBRSxPQUFPLEdBQUcsQ0FBQyxPQUFPLENBQUE7SUFDbkMsUUFBUSxHQUFHLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDakIsS0FBSyxTQUFTLENBQUMsQ0FBQyxPQUFPLFFBQVEsQ0FBQTtRQUMvQixLQUFLLFFBQVEsQ0FBQyxDQUFDLE9BQU8sUUFBUSxDQUFBO1FBQzlCLEtBQUssTUFBTSxDQUFDLENBQUMsT0FBTyxRQUFRLENBQUE7UUFDNUIsS0FBSyxNQUFNLENBQUMsQ0FBQyxPQUFPLE1BQU0sQ0FBQTtRQUMxQixLQUFLLEtBQUssQ0FBQyxDQUFDLE9BQU8sS0FBSyxDQUFBO1FBQ3hCLE9BQU8sQ0FBQyxDQUFDLE9BQU8sTUFBTSxDQUFBO0lBQ3hCLENBQUM7QUFDSCxDQUFDO0FBRUQsU0FBUyxlQUFlLENBQUMsSUFBWSxFQUFFLEdBQWM7SUFDbkQsT0FBTztRQUNMLElBQUk7UUFDSixPQUFPLEVBQUUsVUFBVSxDQUFDLEdBQUcsQ0FBQztRQUN4QixNQUFNLEVBQUUsR0FBRyxDQUFDLE1BQU0sS0FBSyxJQUFJO1FBQzNCLGdHQUFnRztRQUNoRyxRQUFRLEVBQUUsR0FBRyxDQUFDLFFBQVEsS0FBSyxJQUFJLElBQUksR0FBRyxDQUFDLE9BQU8sS0FBSyxTQUFTO1FBQzVELEtBQUssRUFBRSxHQUFHLENBQUMsS0FBSztRQUNoQixJQUFJLEVBQUUsR0FBRyxDQUFDLElBQUk7UUFDZCxXQUFXLEVBQUUsR0FBRyxDQUFDLFdBQVc7UUFDNUIsT0FBTyxFQUFFLEdBQUcsQ0FBQyxJQUFJ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

package/.medusa/server/src/modules/integration/descriptor/meta.d.ts

@@ -0,0 +1,7 @@
+/**
+ * An i18n key resolved admin-side against the merged i18next resources (`t(key)`). Providers
+ * ship the translations from their `src/admin/i18n/index.ts`; missing keys fall back to the
+ * key string itself.
+ */
+export type I18nKey = string;
+export type FieldControl = "text" | "secret" | "switch" | "number" | "url" | "select" | "multiselect" | "json";

package/.medusa/server/src/modules/integration/descriptor/meta.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWV0YS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3NyYy9tb2R1bGVzL2ludGVncmF0aW9uL2Rlc2NyaXB0b3IvbWV0YS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/.medusa/server/src/modules/integration/descriptor/option.d.ts

@@ -0,0 +1,104 @@
+import type { I18nKey, FieldControl } from "./meta";
+export type OptionIssue = {
+    message: string;
+    path?: (string | number)[];
+};
+export type OptionValidateContext = {
+    /** The full merged config (this option's siblings) — cast to read specific keys. */
+    options: Record<string, unknown>;
+    addIssue: (issue: OptionIssue) => void;
+};
+/** Declarative UI-visibility rule, evaluated admin-side against sibling values (JSON-serializable). */
+export type VisibleWhen = {
+    field: string;
+    equals: string | number | boolean;
+};
+type OptionBase = {
+    control?: FieldControl;
+    label: I18nKey;
+    hint?: I18nKey;
+    placeholder?: I18nKey;
+    secret?: boolean;
+    /** Required = rejects `undefined`. Optional by default; a `default` also implies present. */
+    required?: boolean;
+    /** Hide this field in the admin unless the rule holds (UI-only; server requiredness lives in `validate`). */
+    visibleWhen?: VisibleWhen;
+    readonly?: boolean;
+};
+export type StringOption = OptionBase & {
+    type: "string";
+    default?: string;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    validate?: (v: string | undefined, c: OptionValidateContext) => void;
+};
+export type UrlOption = OptionBase & {
+    type: "url";
+    default?: string;
+    /** Restrict the URL scheme, e.g. ["https"]. Omit to allow any protocol. */
+    protocols?: string[];
+    validate?: (v: string | undefined, c: OptionValidateContext) => void;
+};
+export type EmailOption = OptionBase & {
+    type: "email";
+    default?: string;
+    validate?: (v: string | undefined, c: OptionValidateContext) => void;
+};
+export type UuidOption = OptionBase & {
+    type: "uuid";
+    default?: string;
+    validate?: (v: string | undefined, c: OptionValidateContext) => void;
+};
+export type NumberOption = OptionBase & {
+    type: "number";
+    default?: number;
+    min?: number;
+    max?: number;
+    int?: boolean;
+    positive?: boolean;
+    nonnegative?: boolean;
+    multipleOf?: number;
+    validate?: (v: number | undefined, c: OptionValidateContext) => void;
+};
+export type BooleanOption = OptionBase & {
+    type: "boolean";
+    default?: boolean;
+    validate?: (v: boolean | undefined, c: OptionValidateContext) => void;
+};
+export type EnumOption<V extends string = string> = OptionBase & {
+    type: "enum";
+    values: readonly V[];
+    valueLabels?: Partial<Record<V, I18nKey>>;
+    default?: V;
+    validate?: (v: V | undefined, c: OptionValidateContext) => void;
+};
+export type JsonOption = OptionBase & {
+    type: "json";
+    default?: unknown;
+    validate?: (v: unknown, c: OptionValidateContext) => void;
+};
+export type OptionDef = StringOption | UrlOption | EmailOption | UuidOption | NumberOption | BooleanOption | EnumOption | JsonOption;
+export type OptionValue<D> = D extends {
+    type: "enum";
+    values: readonly (infer V)[];
+} ? V : D extends {
+    type: "boolean";
+} ? boolean : D extends {
+    type: "number";
+} ? number : D extends {
+    type: "string" | "url" | "email" | "uuid";
+} ? string : D extends {
+    type: "json";
+} ? unknown : unknown;
+type Present<D> = D extends {
+    default: unknown;
+} ? true : D extends {
+    required: true;
+} ? true : false;
+export type Settings<O extends Record<string, OptionDef>> = {
+    [K in keyof O as Present<O[K]> extends true ? K : never]-?: OptionValue<O[K]>;
+} & {
+    [K in keyof O as Present<O[K]> extends true ? never : K]?: OptionValue<O[K]>;
+};
+export {};

package/.medusa/server/src/modules/integration/descriptor/option.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3B0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vc3JjL21vZHVsZXMvaW50ZWdyYXRpb24vZGVzY3JpcHRvci9vcHRpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9