@collabhut/plugin-sdk 0.1.0

package/dist/types/instrument.js

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

package/dist/types/licensing.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Licensing and collaboration-access types for @collabhut/plugin-sdk.
+ *
+ * ## Overview
+ * CollabDAW verifies plugin licenses server-side on every load.  There is
+ * **no user-facing license key** — the DAW sends the current user's session
+ * token and the plugin's `manifest.id` to the CollabHut API, which returns a
+ * `LicenseCheckResult`.
+ *
+ * ## Collaboration access rules (IMPORTANT)
+ *
+ * A user who does **not** own a license to a paid plugin may still use that
+ * plugin under the following conditions — **all must be true**:
+ *
+ * 1. They are an active participant in a collaboration (`status !== "completed"`).
+ * 2. At least one other participant in that collaboration **does** own a license
+ *    for the plugin.
+ * 3. The plugin's `pricing` field is `"paid"` (free plugins require no license).
+ *
+ * When the collaboration is marked completed, collab-access is revoked.
+ * The user cannot export or render the track if the collab plugin access has
+ * lapsed.
+ *
+ * This policy is enforced both in the DAW runtime (via `LicenseCheckResult`)
+ * and in CollabHut's server API.
+ */
+/** ISO-8601 datetime string */
+type IsoDateString = string;
+/**
+ * Describes the permission granted through a collaboration partner's license.
+ * Only valid while the collaboration is active (not completed).
+ */
+export interface CollaborationAccess {
+    /** The CollabHut collaboration ID granting access */
+    readonly collaborationId: string;
+    /** The user ID of the participant who owns the license */
+    readonly ownerUserId: string;
+    /**
+     * Access expires at this time regardless of collab status.
+     * The DAW must re-verify before this timestamp.
+     * Null = access is valid for the lifetime of the collaboration.
+     */
+    readonly allowedUntil: IsoDateString | null;
+}
+/**
+ * A signed license token returned by the CollabHut API.
+ *
+ * The DAW must not cache this across sessions — it re-verifies on every
+ * project open to handle revocations and collab completions.
+ */
+export interface LicenseToken {
+    /** Plugin manifest ID this token covers */
+    readonly pluginId: string;
+    /** The user ID this token was issued to */
+    readonly userId: string;
+    /**
+     * Type of access:
+     * - `"owned"` — user has purchased (or the plugin is free)
+     * - `"collab"` — access granted through a collaboration partner
+     * - `"free"` — plugin has `pricing: "free"`, no purchase needed
+     */
+    readonly accessType: "owned" | "collab" | "free";
+    /**
+     * Present when `accessType === "collab"`.
+     * Contains collab-specific access constraints.
+     */
+    readonly collaborationAccess?: CollaborationAccess;
+    /**
+     * Token expiry — DAW must re-verify after this time.
+     * Short-lived (typically 1 hour) to support near-real-time revocation.
+     */
+    readonly expiresAt: IsoDateString;
+    /**
+     * Opaque HMAC signature from the CollabHut server.
+     * The DAW validates this against the public key embedded in the app.
+     * Do not store or forward this value.
+     */
+    readonly signature: string;
+}
+/** The DAW was granted access */
+export interface LicenseGranted {
+    readonly granted: true;
+    readonly token: LicenseToken;
+}
+/** The DAW was denied access with a human-readable reason */
+export interface LicenseDenied {
+    readonly granted: false;
+    /**
+     * Machine-readable denial code:
+     * - `"not-purchased"` — user does not own this plugin
+     * - `"collab-completed"` — the collaboration granting access is finished
+     * - `"collab-not-member"` — user is no longer in the collaboration
+     * - `"revoked"` — license was revoked (e.g., charge-back)
+     * - `"expired"` — token is past its `expiresAt` (re-verify required)
+     * - `"plugin-delisted"` — plugin was removed from the marketplace
+     */
+    readonly code: "not-purchased" | "collab-completed" | "collab-not-member" | "revoked" | "expired" | "plugin-delisted";
+    /** Human-readable explanation shown to the user in the DAW */
+    readonly reason: string;
+}
+/** Result of a license verification call */
+export type LicenseCheckResult = LicenseGranted | LicenseDenied;
+/**
+ * DAW-side interface for performing license checks.
+ *
+ * This is injected by the DAW runtime — plugin code never calls it directly.
+ * It is documented here so host environment authors can implement it correctly.
+ */
+export interface LicenseChecker {
+    /**
+     * Verify that the current user may load a plugin.
+     * @param pluginId         The plugin's `manifest.id`
+     * @param collaborationId  Active collaboration context (if any)
+     */
+    check(pluginId: string, collaborationId?: string): Promise<LicenseCheckResult>;
+}
+export {};
+//# sourceMappingURL=licensing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"licensing.d.ts","sourceRoot":"","sources":["../../src/types/licensing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,+BAA+B;AAC/B,KAAK,aAAa,GAAG,MAAM,CAAA;AAE3B;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,qDAAqD;IACrD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,aAAa,GAAG,IAAI,CAAA;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;IAChD;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;IAClD;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC7B;AAED,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;CAC/B;AAED,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,EACP,eAAe,GACf,kBAAkB,GAClB,mBAAmB,GACnB,SAAS,GACT,SAAS,GACT,iBAAiB,CAAA;IACvB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAC1B;AAED,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,aAAa,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC3B;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;CACjF"}

package/dist/types/licensing.js

@@ -0,0 +1,27 @@
+/**
+ * Licensing and collaboration-access types for @collabhut/plugin-sdk.
+ *
+ * ## Overview
+ * CollabDAW verifies plugin licenses server-side on every load.  There is
+ * **no user-facing license key** — the DAW sends the current user's session
+ * token and the plugin's `manifest.id` to the CollabHut API, which returns a
+ * `LicenseCheckResult`.
+ *
+ * ## Collaboration access rules (IMPORTANT)
+ *
+ * A user who does **not** own a license to a paid plugin may still use that
+ * plugin under the following conditions — **all must be true**:
+ *
+ * 1. They are an active participant in a collaboration (`status !== "completed"`).
+ * 2. At least one other participant in that collaboration **does** own a license
+ *    for the plugin.
+ * 3. The plugin's `pricing` field is `"paid"` (free plugins require no license).
+ *
+ * When the collaboration is marked completed, collab-access is revoked.
+ * The user cannot export or render the track if the collab plugin access has
+ * lapsed.
+ *
+ * This policy is enforced both in the DAW runtime (via `LicenseCheckResult`)
+ * and in CollabHut's server API.
+ */
+export {};

package/dist/types/manifest.d.ts

@@ -0,0 +1,90 @@
+import type { PluginParam } from "./parameters";
+/** Semantic version string, e.g. "1.2.3" */
+export type SemVer = `${number}.${number}.${number}`;
+/** Plugin type identifier */
+export type PluginType = "audio-effect" | "midi-effect" | "instrument" | "vocal-preset" | "shader";
+/** Plugin pricing model */
+export type PluginPricing = "free" | "paid";
+/** Author / publisher information */
+export interface PluginAuthor {
+    /** Display name */
+    readonly name: string;
+    /** Homepage or portfolio URL */
+    readonly url?: string;
+    /** Contact email (never shown to end-users, only used for support) */
+    readonly email?: string;
+}
+/**
+ * Plugin manifest — the single source of truth for every plugin.
+ *
+ * Export a value conforming to this interface from your plugin module as
+ * `export const manifest: PluginManifest = { ... }`.  CollabHut reads the
+ * manifest at upload time to populate the marketplace listing and at runtime
+ * to validate the loaded plugin against the executing CollabDAW version.
+ *
+ * @example
+ * ```ts
+ * import type { PluginManifest } from "@collabhut/plugin-sdk"
+ *
+ * export const manifest: PluginManifest = {
+ *     id: "com.myorg.warm-compressor",
+ *     name: "Warm Compressor",
+ *     version: "1.0.0",
+ *     type: "audio-effect",
+ *     description: "Analogue-style VCA compressor with harmonic saturation.",
+ *     author: { name: "Your Name", url: "https://example.com" },
+ *     pricing: "paid",
+ *     minApiVersion: "0.1.0",
+ *     tags: ["dynamics", "compressor", "vintage"],
+ * }
+ * ```
+ */
+export interface PluginManifest {
+    /**
+     * Globally unique identifier in reverse-domain notation.
+     * Must be stable — changing this after publication breaks licensing.
+     * @example "com.myorg.warm-compressor"
+     */
+    readonly id: string;
+    /** Human-readable display name shown in the DAW device browser */
+    readonly name: string;
+    /** Semantic version following semver.org */
+    readonly version: SemVer;
+    /** Plugin category — determines where it appears in the device browser */
+    readonly type: PluginType;
+    /**
+     * Short description shown in the marketplace (max 280 characters).
+     * Write this for musicians, not engineers.
+     */
+    readonly description: string;
+    /** Author / publisher information */
+    readonly author: PluginAuthor;
+    /** Optional homepage URL for marketing / documentation */
+    readonly homepage?: string;
+    /** Tags for search and discoverability in the marketplace */
+    readonly tags?: readonly string[];
+    /**
+     * Parameter definitions exposed to the DAW automation lane and UI.
+     * Each param becomes a knob, slider, or toggle in the device editor.
+     */
+    readonly params?: readonly PluginParam[];
+    /**
+     * Pricing model.
+     * - `"free"` — no purchase required; runs on all plans
+     * - `"paid"` — requires a CollabHut marketplace purchase to use outside
+     *              of a collaboration where another participant owns a licence
+     */
+    readonly pricing: PluginPricing;
+    /**
+     * Minimum @collabhut/plugin-sdk runtime version the plugin requires.
+     * CollabDAW will refuse to load the plugin if the runtime version is lower.
+     */
+    readonly minApiVersion: SemVer;
+    /**
+     * Whether this plugin is compatible with ShaderToy integration.
+     * Only relevant for `type: "shader"` plugins.
+     * @default false
+     */
+    readonly shadertoyCompatible?: boolean;
+}
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/types/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,4CAA4C;AAC5C,MAAM,MAAM,MAAM,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAA;AAEpD,6BAA6B;AAC7B,MAAM,MAAM,UAAU,GAChB,cAAc,GACd,aAAa,GACb,YAAY,GACZ,cAAc,GACd,QAAQ,CAAA;AAEd,2BAA2B;AAC3B,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAA;AAE3C,qCAAqC;AACrC,MAAM,WAAW,YAAY;IACzB,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gCAAgC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,cAAc;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IAEzB;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAE5B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAE7B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAE1B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAEjC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAExC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAE/B;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CACzC"}

package/dist/types/manifest.js

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

package/dist/types/midi-effect.d.ts

@@ -0,0 +1,101 @@
+import type { PluginContext } from "./context";
+import type { PluginManifest } from "./manifest";
+/** Standard MIDI event types */
+export type MidiEventType = "note-on" | "note-off" | "control-change" | "pitch-bend" | "aftertouch" | "poly-aftertouch" | "program-change";
+/** Base MIDI event — every event carries timing in beats from song start */
+interface MidiEventBase {
+    readonly channel: number;
+    readonly beatTime: number;
+}
+/** A MIDI note-on event */
+export interface MidiNoteOnEvent extends MidiEventBase {
+    readonly type: "note-on";
+    readonly note: number;
+    readonly velocity: number;
+}
+/** A MIDI note-off event */
+export interface MidiNoteOffEvent extends MidiEventBase {
+    readonly type: "note-off";
+    readonly note: number;
+    readonly velocity: number;
+}
+/** A MIDI continuous controller event */
+export interface MidiControlChangeEvent extends MidiEventBase {
+    readonly type: "control-change";
+    readonly controller: number;
+    readonly value: number;
+}
+/** A MIDI pitch bend event */
+export interface MidiPitchBendEvent extends MidiEventBase {
+    readonly type: "pitch-bend";
+    readonly value: number;
+}
+/** Channel pressure (aftertouch) */
+export interface MidiAftertouchEvent extends MidiEventBase {
+    readonly type: "aftertouch";
+    readonly pressure: number;
+}
+/** Poly aftertouch (note-specific pressure) */
+export interface MidiPolyAftertouchEvent extends MidiEventBase {
+    readonly type: "poly-aftertouch";
+    readonly note: number;
+    readonly pressure: number;
+}
+/** Program change */
+export interface MidiProgramChangeEvent extends MidiEventBase {
+    readonly type: "program-change";
+    readonly program: number;
+}
+/** Discriminated union of all MIDI events */
+export type MidiEvent = MidiNoteOnEvent | MidiNoteOffEvent | MidiControlChangeEvent | MidiPitchBendEvent | MidiAftertouchEvent | MidiPolyAftertouchEvent | MidiProgramChangeEvent;
+/**
+ * MIDI effect processor.
+ *
+ * Receives the list of MIDI events for the current audio block and returns
+ * transformed / generated events.  Returning an empty array silences all
+ * MIDI output for that block.
+ *
+ * @example
+ * ```ts
+ * import type { MidiEffectFactory, MidiEvent } from "@collabhut/plugin-sdk"
+ *
+ * // Chord generator — fan every note-on into a major chord
+ * export const factory: MidiEffectFactory = (_context, params) => ({
+ *     process(events) {
+ *         const out: MidiEvent[] = []
+ *         for (const ev of events) {
+ *             out.push(ev)
+ *             if (ev.type === "note-on") {
+ *                 out.push({ ...ev, note: ev.note + 4 })  // major third
+ *                 out.push({ ...ev, note: ev.note + 7 })  // perfect fifth
+ *             } else if (ev.type === "note-off") {
+ *                 out.push({ ...ev, note: ev.note + 4 })
+ *                 out.push({ ...ev, note: ev.note + 7 })
+ *             }
+ *         }
+ *         return out
+ *     },
+ *     dispose() {},
+ * })
+ * ```
+ */
+export interface MidiEffectPlugin {
+    /**
+     * Called once per audio block.
+     * @param events   Events arriving in this block (sorted by beatTime)
+     * @returns        Transformed or generated events for downstream
+     */
+    process(events: ReadonlyArray<MidiEvent>): MidiEvent[];
+    /** Called by the DAW when the plugin is removed or the project closes */
+    dispose(): void;
+}
+export type MidiEffectFactory = (context: PluginContext, params: Readonly<Record<string, number | boolean | string>>, manifest: PluginManifest) => MidiEffectPlugin;
+/** Full MIDI-effect module shape */
+export interface MidiEffectModule {
+    readonly manifest: PluginManifest & {
+        readonly type: "midi-effect";
+    };
+    readonly factory: MidiEffectFactory;
+}
+export {};
+//# sourceMappingURL=midi-effect.d.ts.map

package/dist/types/midi-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"midi-effect.d.ts","sourceRoot":"","sources":["../../src/types/midi-effect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,gCAAgC;AAChC,MAAM,MAAM,aAAa,GACnB,SAAS,GACT,UAAU,GACV,gBAAgB,GAChB,YAAY,GACZ,YAAY,GACZ,iBAAiB,GACjB,gBAAgB,CAAA;AAEtB,4EAA4E;AAC5E,UAAU,aAAa;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC5B;AAED,2BAA2B;AAC3B,MAAM,WAAW,eAAgB,SAAQ,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC5B;AAED,4BAA4B;AAC5B,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACnD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC5B;AAED,yCAAyC;AACzC,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IACzD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACzB;AAED,8BAA8B;AAC9B,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACrD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACzB;AAED,oCAAoC;AACpC,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACtD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC5B;AAED,+CAA+C;AAC/C,MAAM,WAAW,uBAAwB,SAAQ,aAAa;IAC1D,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC5B;AAED,qBAAqB;AACrB,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IACzD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAC3B;AAED,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GACf,eAAe,GACf,gBAAgB,GAChB,sBAAsB,GACtB,kBAAkB,GAClB,mBAAmB,GACnB,uBAAuB,GACvB,sBAAsB,CAAA;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,SAAS,EAAE,CAAA;IACtD,yEAAyE;IACzE,OAAO,IAAI,IAAI,CAAA;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC5B,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC,EAC3D,QAAQ,EAAE,cAAc,KACvB,gBAAgB,CAAA;AAErB,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;KAAE,CAAA;IACpE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;CACtC"}

package/dist/types/midi-effect.js

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

package/dist/types/parameters.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Parameter curve controls how raw 0–1 knob values map to parameter values.
+ * - `"linear"` — equal steps
+ * - `"log"` — logarithmic, good for frequency and time
+ * - `"exp"` — exponential, good for gain/amplitude
+ */
+export type ParamCurve = "linear" | "log" | "exp";
+/** Data type for a discrete-choice parameter */
+export interface ChoiceOption {
+    readonly value: string;
+    readonly label: string;
+}
+/**
+ * Continuous (knob/slider) parameter definition.
+ *
+ * @example
+ * ```ts
+ * {
+ *     id: "cutoff",
+ *     label: "Cutoff",
+ *     type: "range",
+ *     min: 20,
+ *     max: 20000,
+ *     default: 1000,
+ *     unit: "Hz",
+ *     curve: "log",
+ * }
+ * ```
+ */
+export interface RangeParam {
+    readonly type: "range";
+    /** Unique identifier within this plugin's parameter set */
+    readonly id: string;
+    /** Display label shown in the device editor */
+    readonly label: string;
+    readonly min: number;
+    readonly max: number;
+    readonly default: number;
+    /** Optional unit shown next to the value, e.g. "Hz", "dB", "ms" */
+    readonly unit?: string;
+    readonly curve?: ParamCurve;
+    /** Number of decimal places shown in the UI */
+    readonly decimals?: number;
+    /** Optional automation grouping label */
+    readonly group?: string;
+}
+/**
+ * Boolean (on/off) parameter — rendered as a toggle button.
+ */
+export interface BoolParam {
+    readonly type: "bool";
+    readonly id: string;
+    readonly label: string;
+    readonly default: boolean;
+    readonly group?: string;
+}
+/**
+ * Discrete-choice parameter — rendered as a dropdown.
+ */
+export interface ChoiceParam {
+    readonly type: "choice";
+    readonly id: string;
+    readonly label: string;
+    readonly choices: readonly ChoiceOption[];
+    readonly default: string;
+    readonly group?: string;
+}
+export type PluginParam = RangeParam | BoolParam | ChoiceParam;
+/**
+ * Type-safe map from param IDs to values.
+ * Produced by the runtime from the current automation state.
+ */
+export type ParamValues<T extends ReadonlyArray<PluginParam>> = {
+    readonly [P in T[number] as P["id"]]: P extends RangeParam ? number : P extends BoolParam ? boolean : string;
+};
+//# sourceMappingURL=parameters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../src/types/parameters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAA;AAEjD,gDAAgD;AAChD,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAA;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAA;AAE9D;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,aAAa,CAAC,WAAW,CAAC,IAAI;IAC5D,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,UAAU,GACpD,MAAM,GACN,CAAC,SAAS,SAAS,GACnB,OAAO,GACP,MAAM;CACf,CAAA"}

package/dist/types/parameters.js

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

package/dist/types/shader.d.ts

@@ -0,0 +1,110 @@
+import type { PluginManifest } from "./manifest";
+/**
+ * GLSL uniform value types that a shader plugin may declare.
+ * The DAW populates these automatically from session state or from plugin params.
+ */
+export type UniformType = "float" | "int" | "vec2" | "vec3" | "vec4" | "bool" | "sampler2D";
+/** A declared GLSL uniform with its source mapping */
+export interface ShaderUniform {
+    /** Uniform name as it appears in the GLSL source */
+    readonly name: string;
+    readonly type: UniformType;
+    /**
+     * How this uniform is populated at runtime:
+     * - `"param"` — maps to a plugin param by id (must match a `manifest.params` entry)
+     * - `"audio-rms"` — root mean square of the current audio block (float, 0–1)
+     * - `"audio-spectrum"` — frequency magnitudes as a sampler2D (1×512 texture)
+     * - `"beat"` — current fractional beat position (float)
+     * - `"bpm"` — session BPM (float)
+     * - `"time"` — elapsed playback time in seconds (matches ShaderToy `iTime`)
+     * - `"resolution"` — canvas size as vec2 (matches ShaderToy `iResolution`)
+     * - `"mouse"` — cursor position as vec2 (matches ShaderToy `iMouse`)
+     */
+    readonly source: "param" | "audio-rms" | "audio-spectrum" | "beat" | "bpm" | "time" | "resolution" | "mouse";
+    /** Required when source is "param" — must match a manifest.params entry id */
+    readonly paramId?: string;
+}
+/**
+ * Shader plugin definition.
+ *
+ * The `glsl` field must be a valid WebGL2 fragment shader.
+ *
+ * ### ShaderToy Compatibility
+ * When `manifest.shadertoyCompatible` is `true`, the DAW automatically injects
+ * the standard ShaderToy uniforms (`iTime`, `iResolution`, `iMouse`,
+ * `iChannel0`–`iChannel3`) so ShaderToy code can be pasted with minimal changes.
+ *
+ * You **do not** need to declare those as `uniforms` — they are added
+ * automatically.  Custom uniforms you declare are added on top.
+ *
+ * ### Security
+ * Shader source is validated server-side before being accepted by the
+ * marketplace.  Prohibited constructs: infinite loops without exit guards,
+ * texture fetches to external URIs, GLSL extensions that could leak device
+ * fingerprints.
+ *
+ * @example Basic audio-reactive shader
+ * ```ts
+ * import type { ShaderModule } from "@collabhut/plugin-sdk"
+ *
+ * const mod: ShaderModule = {
+ *     manifest: {
+ *         id: "com.myorg.pulse-visualiser",
+ *         name: "Pulse Visualiser",
+ *         version: "1.0.0",
+ *         type: "shader",
+ *         description: "Circle that pulses with the music",
+ *         author: { name: "My Org" },
+ *         pricing: "free",
+ *         minApiVersion: "0.1.0",
+ *         shadertoyCompatible: false,
+ *     },
+ *     shader: {
+ *         glsl: `
+ *             precision mediump float;
+ *             uniform vec2  uResolution;
+ *             uniform float uRms;
+ *             void main() {
+ *                 vec2 uv = (gl_FragCoord.xy / uResolution) * 2.0 - 1.0;
+ *                 float r = length(uv);
+ *                 float circle = smoothstep(0.5 + uRms * 0.4, 0.49 + uRms * 0.4, r);
+ *                 gl_FragColor = vec4(vec3(circle), 1.0);
+ *             }
+ *         `,
+ *         uniforms: [
+ *             { name: "uResolution", type: "vec2",  source: "resolution" },
+ *             { name: "uRms",        type: "float", source: "audio-rms"  },
+ *         ],
+ *     },
+ * }
+ *
+ * export default mod
+ * ```
+ *
+ * @example ShaderToy port
+ * ```ts
+ * // manifest.shadertoyCompatible = true
+ * // iTime, iResolution, iMouse, iChannel0 are pre-injected
+ * const glsl = `
+ *     void mainImage(out vec4 fragColor, in vec2 fragCoord) {
+ *         vec2 uv = fragCoord / iResolution.xy;
+ *         fragColor = vec4(uv, 0.5 + 0.5 * sin(iTime), 1.0);
+ *     }
+ * `
+ * ```
+ */
+export interface ShaderDefinition {
+    /** Fragment shader source (WebGL2 / GLSL ES 300 or 100) */
+    readonly glsl: string;
+    /** Custom uniform declarations */
+    readonly uniforms?: readonly ShaderUniform[];
+}
+/** Full shader plugin module shape */
+export interface ShaderModule {
+    readonly manifest: PluginManifest & {
+        readonly type: "shader";
+        readonly shadertoyCompatible?: boolean;
+    };
+    readonly shader: ShaderDefinition;
+}
+//# sourceMappingURL=shader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shader.d.ts","sourceRoot":"","sources":["../../src/types/shader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD;;;GAGG;AACH,MAAM,MAAM,WAAW,GACjB,OAAO,GACP,KAAK,GACL,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,WAAW,CAAA;AAEjB,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,MAAM,EACT,OAAO,GACP,WAAW,GACX,gBAAgB,GAChB,MAAM,GACN,KAAK,GACL,MAAM,GACN,YAAY,GACZ,OAAO,CAAA;IACb,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;CAC/C;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG;QAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;QACvB,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;KACzC,CAAA;IACD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;CACpC"}

package/dist/types/shader.js

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