@supatype/plugin-sdk 0.1.0-alpha.9

package/dist/loader.js

@@ -0,0 +1,282 @@
+/**
+ * Plugin discovery and loading utilities.
+ *
+ * The plugin loader scans node_modules for packages with the `supatype-plugin`
+ * keyword or a `supatype` field in package.json, and auto-registers them.
+ */
+import { PLUGIN_API_VERSION, } from "./types.js";
+import { checkPluginApiVersion, } from "./define.js";
+const registry = new Map();
+/**
+ * Register a plugin definition.
+ */
+export function registerPlugin(packageName, definition) {
+    const meta = definition.meta ?? {
+        name: packageName,
+        description: "",
+        types: [definition.__supatype],
+        pluginApi: PLUGIN_API_VERSION,
+    };
+    const compat = checkPluginApiVersion(meta);
+    const plugin = {
+        packageName,
+        meta,
+        definition,
+        status: compat.compatible ? "active" : "incompatible",
+        ...(compat.message !== undefined ? { incompatibleReason: compat.message } : {}),
+    };
+    // Check for conflicts
+    const existing = registry.get(definition.__supatype === "field"
+        ? `field:${definition.name}`
+        : definition.__supatype === "provider"
+            ? `provider:${definition.category}:${definition.name}`
+            : `${definition.__supatype}:${definition.name}`);
+    if (existing) {
+        console.warn(`[plugins] conflict: "${packageName}" and "${existing.packageName}" both define ` +
+            `${definition.__supatype} "${definition.name}". ` +
+            `Resolve in supatype.config.ts plugins array.`);
+    }
+    const key = `${definition.__supatype}:${definition.name}`;
+    registry.set(key, plugin);
+    return plugin;
+}
+/**
+ * Get all registered plugins.
+ */
+export function getRegisteredPlugins() {
+    return Array.from(registry.values());
+}
+/**
+ * Get plugins by type.
+ */
+export function getPluginsByType(type) {
+    return getRegisteredPlugins().filter(p => p.definition.__supatype === type);
+}
+/**
+ * Get a specific field type plugin by name.
+ */
+export function getFieldTypePlugin(name) {
+    return registry.get(`field:${name}`);
+}
+/**
+ * Get a specific provider plugin by category and name.
+ */
+export function getProviderPlugin(category, name) {
+    return registry.get(`provider:${category}:${name}`);
+}
+/**
+ * Clear the plugin registry (for testing).
+ */
+export function clearPluginRegistry() {
+    registry.clear();
+}
+/**
+ * Check if a package.json represents a Supatype plugin.
+ */
+export function isSupatypePlugin(pkg) {
+    // Has a `supatype` field in package.json
+    if (pkg.supatype)
+        return true;
+    // Has `supatype-plugin` keyword
+    if (pkg.keywords?.includes("supatype-plugin"))
+        return true;
+    return false;
+}
+// ─── Load order ──────────────────────────────────────────────────────────────
+/**
+ * Sort plugins by load order: providers first, then fields & composites, then widgets.
+ */
+export function sortByLoadOrder(plugins) {
+    const order = {
+        provider: 0,
+        field: 1,
+        composite: 2,
+        widget: 3,
+    };
+    return [...plugins].sort((a, b) => {
+        const aOrder = order[a.definition.__supatype] ?? 99;
+        const bOrder = order[b.definition.__supatype] ?? 99;
+        return aOrder - bOrder;
+    });
+}
+/**
+ * Detect conflicts between a set of plugin definitions.
+ */
+export function detectConflicts(plugins) {
+    const seen = new Map();
+    const conflicts = [];
+    for (const p of plugins) {
+        const key = `${p.definition.__supatype}:${p.definition.name}`;
+        const existing = seen.get(key) ?? [];
+        existing.push(p.packageName);
+        seen.set(key, existing);
+    }
+    for (const [key, packages] of seen) {
+        if (packages.length > 1) {
+            const [type, name] = key.split(":", 2);
+            conflicts.push({
+                type: type,
+                name: name,
+                packages,
+                message: `Multiple plugins define ${type} "${name}": ${packages.join(", ")}. ` +
+                    `Resolve by explicitly listing plugins in supatype.config.ts.`,
+            });
+        }
+    }
+    return conflicts;
+}
+// ─── Provider validation (Task 11) ──────────────────────────────────────────
+/** Optional methods on each provider category that should trigger warnings, not errors. */
+const OPTIONAL_PROVIDER_METHODS = {
+    commerce: ["createSubscription", "cancelSubscription", "getPortalUrl"],
+    tracking: ["groupIdentify", "getFeatureFlag"],
+    email: ["sendTemplate", "sendBatch"],
+    storage: [],
+    auth: [],
+    ssl: [],
+    ai: [],
+    search: [],
+    "push-notification": [],
+};
+/**
+ * Validate configured providers at push time.
+ *
+ * For each provider:
+ * - Checks the definition has a `create()` method
+ * - Checks required `configSchema` fields are present in the config
+ * - Warns about optional interface methods not implemented
+ */
+export function validateProviders(configuredProviders) {
+    const warnings = [];
+    const errors = [];
+    for (const cp of configuredProviders) {
+        // Find matching registered provider plugin
+        const registered = getRegisteredPlugins().find(p => p.definition.__supatype === "provider" && p.definition.name === cp.name);
+        if (!registered) {
+            errors.push(`Provider "${cp.name}" is configured but no matching plugin is registered.`);
+            continue;
+        }
+        if (registered.status === "incompatible") {
+            errors.push(`Provider "${cp.name}" is incompatible: ${registered.incompatibleReason ?? "unknown reason"}.`);
+            continue;
+        }
+        const def = registered.definition;
+        // Check create() method
+        if (typeof def.create !== "function") {
+            errors.push(`Provider "${cp.name}" definition is missing a create() method.`);
+        }
+        // Check required configSchema fields are present in config
+        if (def.configSchema && cp.config) {
+            for (const [key, schema] of Object.entries(def.configSchema)) {
+                if (schema.required === true && (cp.config[key] === undefined || cp.config[key] === null)) {
+                    errors.push(`Provider "${cp.name}" is missing required config field "${key}".`);
+                }
+            }
+        }
+        else if (def.configSchema && !cp.config) {
+            const requiredFields = Object.entries(def.configSchema)
+                .filter(([, s]) => s.required === true)
+                .map(([k]) => k);
+            if (requiredFields.length > 0) {
+                errors.push(`Provider "${cp.name}" has required config fields (${requiredFields.join(", ")}) but no config was provided.`);
+            }
+        }
+        // Warn about optional interface methods
+        const optionalMethods = OPTIONAL_PROVIDER_METHODS[def.category] ?? [];
+        if (optionalMethods.length > 0 && typeof def.create === "function") {
+            for (const method of optionalMethods) {
+                // We can only check if the create function produces an instance with
+                // the method at runtime, so we note the optional methods as warnings.
+                warnings.push(`Provider "${cp.name}" (${def.category}): optional method "${method}" may not be implemented.`);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        warnings,
+        errors,
+    };
+}
+// ─── Plugin field type map (Task 15) ────────────────────────────────────────
+/**
+ * Returns a map of custom field type names to their declared `tsType` values
+ * from registered field type plugins. Consumed by the engine's type generator.
+ */
+export function getPluginFieldTypeMap() {
+    const map = new Map();
+    for (const plugin of getPluginsByType("field")) {
+        if (plugin.status !== "active")
+            continue;
+        const def = plugin.definition;
+        map.set(def.name, def.tsType);
+    }
+    return map;
+}
+/**
+ * Returns a map of custom field type names to their Postgres type and optional
+ * constraints. Consumed by the engine's migration system.
+ */
+export function getPluginFieldPgTypeMap() {
+    const map = new Map();
+    for (const plugin of getPluginsByType("field")) {
+        if (plugin.status !== "active")
+            continue;
+        const def = plugin.definition;
+        map.set(def.name, {
+            pgType: def.pgType,
+            ...(def.constraints !== undefined ? { constraints: def.constraints } : {}),
+        });
+    }
+    return map;
+}
+/** Built-in type-to-pgType mapping for common types. */
+const BUILTIN_PG_TYPES = {
+    text: "TEXT",
+    varchar: "VARCHAR",
+    boolean: "BOOLEAN",
+    integer: "INTEGER",
+    bigint: "BIGINT",
+    float: "FLOAT8",
+    decimal: "NUMERIC",
+    json: "JSONB",
+    jsonb: "JSONB",
+    date: "DATE",
+    timestamp: "TIMESTAMPTZ",
+    uuid: "UUID",
+};
+/**
+ * Expand registered composite plugins into their concrete field definitions
+ * with resolved Postgres types.
+ *
+ * For each composite field, the type is resolved by:
+ * 1. Checking registered plugin field types (from getPluginFieldPgTypeMap)
+ * 2. Falling back to built-in type mappings
+ * 3. Defaulting to TEXT if no match is found
+ */
+export function expandPluginComposites() {
+    const result = new Map();
+    const pluginFieldPgTypes = getPluginFieldPgTypeMap();
+    for (const plugin of getPluginsByType("composite")) {
+        if (plugin.status !== "active")
+            continue;
+        const def = plugin.definition;
+        const fields = def.fields.map((f) => {
+            // Resolve pgType: plugin fields first, then built-ins, then TEXT fallback
+            const pluginPg = pluginFieldPgTypes.get(f.type);
+            const pgType = pluginPg?.pgType ?? BUILTIN_PG_TYPES[f.type] ?? "TEXT";
+            return {
+                name: f.name,
+                pgType,
+                required: f.required === true,
+                ...(f.defaultValue !== undefined ? { defaultValue: f.defaultValue } : {}),
+            };
+        });
+        result.set(def.name, {
+            fields,
+            ...(def.installSQL !== undefined ? { installSQL: def.installSQL } : {}),
+            ...(def.uninstallSQL !== undefined ? { uninstallSQL: def.uninstallSQL } : {}),
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,341 @@
+/**
+ * Core plugin system types for @supatype/plugin-sdk.
+ *
+ * Every Supatype plugin is an npm package that exports one or more of:
+ *   - Field type definitions (defineFieldType)
+ *   - Composite definitions (defineComposite)
+ *   - Provider implementations (defineProvider)
+ *   - Widget definitions (defineWidget)
+ */
+/** Plugin API version — used for compatibility checking. */
+export declare const PLUGIN_API_VERSION = 1;
+export type PluginType = "field" | "composite" | "provider" | "widget";
+export interface PluginMeta {
+    /** Plugin name (npm package name) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Plugin type(s) */
+    types: PluginType[];
+    /** Plugin API version this plugin targets */
+    pluginApi: number;
+    /** Minimum compatible Supatype version (semver) */
+    supatypeVersion?: string | undefined;
+}
+export interface FieldTypeDefinition<TValue = unknown> {
+    /** Unique field type name (e.g., "phone", "currency", "slug") */
+    name: string;
+    /** Postgres column type (e.g., "TEXT", "JSONB", "INTEGER") */
+    pgType: string;
+    /** TypeScript type string for code generation (e.g., "string", "number", "PhoneNumber") */
+    tsType: string;
+    /** Optional default value expression */
+    defaultExpression?: string | undefined;
+    /** Validate a value — return null if valid, error message if invalid */
+    validate?(value: unknown): string | null;
+    /** Serialise a TypeScript value to a Postgres-compatible value */
+    serialise?(value: TValue): unknown;
+    /** Deserialise a Postgres value to a TypeScript value */
+    deserialise?(raw: unknown): TValue;
+    /** Supported filter operators (default: eq, neq, in) */
+    filterOperators?: string[] | undefined;
+    /** Path to React widget component (relative to plugin package root) */
+    widgetPath?: string | undefined;
+    /** Additional Postgres constraints (e.g., CHECK expressions) */
+    constraints?: string[] | undefined;
+    /** Plugin metadata */
+    meta?: PluginMeta | undefined;
+}
+export interface CompositeFieldDef {
+    /** Field name */
+    name: string;
+    /** Built-in or plugin field type */
+    type: string;
+    /** Whether the field is required */
+    required?: boolean | undefined;
+    /** Default value */
+    defaultValue?: unknown | undefined;
+    /** Additional field options */
+    options?: Record<string, unknown> | undefined;
+}
+export interface CompositeDefinition {
+    /** Unique composite name (e.g., "seo", "address", "social-links") */
+    name: string;
+    /** Human-readable label for the admin panel */
+    label: string;
+    /** Fields this composite adds to a model */
+    fields: CompositeFieldDef[];
+    /** Admin panel grouping — how fields should be displayed */
+    adminGroup?: {
+        /** Collapsible group? Default: true */
+        collapsible?: boolean | undefined;
+        /** Default collapsed state? Default: false */
+        defaultCollapsed?: boolean | undefined;
+    } | undefined;
+    /** SQL to execute when the composite is first applied (e.g., trigger creation) */
+    installSQL?: string | undefined;
+    /** SQL to execute when the composite is removed */
+    uninstallSQL?: string | undefined;
+    /** Plugin metadata */
+    meta?: PluginMeta | undefined;
+}
+export type ProviderCategory = "commerce" | "tracking" | "email" | "storage" | "auth" | "ssl" | "ai" | "search" | "push-notification";
+export interface ProviderDefinition<TConfig = Record<string, unknown>> {
+    /** Unique provider name (e.g., "stripe", "posthog", "resend") */
+    name: string;
+    /** Provider category */
+    category: ProviderCategory;
+    /** Human-readable label */
+    label: string;
+    /** Configuration schema — used for validation and Studio settings UI */
+    configSchema: Record<string, {
+        type: "string" | "number" | "boolean" | "select";
+        label: string;
+        required?: boolean | undefined;
+        default?: unknown | undefined;
+        options?: string[] | undefined;
+        secret?: boolean | undefined;
+    }>;
+    /** Create a provider instance from config */
+    create(config: TConfig): unknown;
+    /** Plugin metadata */
+    meta?: PluginMeta | undefined;
+}
+export interface CommerceProvider {
+    /** Create or sync a product */
+    syncProduct(product: {
+        id: string;
+        name: string;
+        description?: string | undefined;
+        active: boolean;
+        prices: Array<{
+            amount: number;
+            currency: string;
+            interval?: string | undefined;
+        }>;
+    }): Promise<{
+        externalId: string;
+    }>;
+    /** Create a checkout session */
+    createCheckout(params: {
+        customerId?: string | undefined;
+        lineItems: Array<{
+            priceId: string;
+            quantity: number;
+        }>;
+        successUrl: string;
+        cancelUrl: string;
+        metadata?: Record<string, string> | undefined;
+    }): Promise<{
+        url: string;
+        sessionId: string;
+    }>;
+    /** Create a subscription */
+    createSubscription?(params: {
+        customerId: string;
+        priceId: string;
+        metadata?: Record<string, string> | undefined;
+    }): Promise<{
+        subscriptionId: string;
+        status: string;
+    }>;
+    /** Cancel a subscription */
+    cancelSubscription?(subscriptionId: string): Promise<void>;
+    /** Create a customer portal URL */
+    getPortalUrl?(customerId: string, returnUrl: string): Promise<string>;
+    /** Handle a webhook payload — returns the parsed event */
+    handleWebhook(payload: string, signature: string): Promise<{
+        type: string;
+        data: unknown;
+    }>;
+}
+export interface TrackingProvider {
+    /** Capture an event */
+    capture(event: {
+        distinctId: string;
+        eventName: string;
+        properties?: Record<string, unknown> | undefined;
+        timestamp?: Date | undefined;
+    }): Promise<void>;
+    /** Identify a user */
+    identify(params: {
+        distinctId: string;
+        properties: Record<string, unknown>;
+    }): Promise<void>;
+    /** Identify a group */
+    groupIdentify?(params: {
+        groupType: string;
+        groupKey: string;
+        properties: Record<string, unknown>;
+    }): Promise<void>;
+    /** Evaluate a feature flag */
+    getFeatureFlag?(params: {
+        key: string;
+        distinctId: string;
+        properties?: Record<string, unknown> | undefined;
+    }): Promise<boolean | string>;
+}
+export interface EmailProvider {
+    /** Send a single email */
+    send(params: {
+        to: string | string[];
+        subject: string;
+        html?: string | undefined;
+        text?: string | undefined;
+        from?: string | undefined;
+        replyTo?: string | undefined;
+        headers?: Record<string, string> | undefined;
+    }): Promise<{
+        messageId: string;
+    }>;
+    /** Send using a template */
+    sendTemplate?(params: {
+        to: string | string[];
+        templateId: string;
+        data: Record<string, unknown>;
+        from?: string | undefined;
+    }): Promise<{
+        messageId: string;
+    }>;
+    /** Send batch emails */
+    sendBatch?(messages: Array<{
+        to: string;
+        subject: string;
+        html?: string | undefined;
+        text?: string | undefined;
+    }>): Promise<{
+        messageIds: string[];
+    }>;
+}
+export interface StorageProvider {
+    /** Upload a file */
+    upload(params: {
+        bucket: string;
+        path: string;
+        body: Uint8Array | ReadableStream;
+        contentType?: string | undefined;
+        metadata?: Record<string, string> | undefined;
+    }): Promise<{
+        key: string;
+        size: number;
+    }>;
+    /** Download a file */
+    download(params: {
+        bucket: string;
+        path: string;
+    }): Promise<{
+        body: ReadableStream;
+        contentType: string;
+        size: number;
+    }>;
+    /** Delete a file */
+    delete(params: {
+        bucket: string;
+        path: string;
+    }): Promise<void>;
+    /** List files in a path */
+    list(params: {
+        bucket: string;
+        prefix?: string | undefined;
+        limit?: number | undefined;
+        cursor?: string | undefined;
+    }): Promise<{
+        items: Array<{
+            key: string;
+            size: number;
+            lastModified: Date;
+        }>;
+        cursor?: string | undefined;
+    }>;
+    /** Generate a pre-signed URL */
+    getSignedUrl(params: {
+        bucket: string;
+        path: string;
+        expiresIn: number;
+        operation?: "read" | "write" | undefined;
+    }): Promise<string>;
+}
+export interface AuthProvider {
+    /** Sign up with email/password */
+    signUp(params: {
+        email: string;
+        password: string;
+        metadata?: Record<string, unknown> | undefined;
+    }): Promise<{
+        userId: string;
+        session?: {
+            accessToken: string;
+            refreshToken: string;
+        } | undefined;
+    }>;
+    /** Sign in with email/password */
+    signIn(params: {
+        email: string;
+        password: string;
+    }): Promise<{
+        userId: string;
+        session: {
+            accessToken: string;
+            refreshToken: string;
+        };
+    }>;
+    /** Sign out */
+    signOut(accessToken: string): Promise<void>;
+    /** Refresh a session */
+    refreshSession(refreshToken: string): Promise<{
+        accessToken: string;
+        refreshToken: string;
+    }>;
+    /** Get user by access token */
+    getUser(accessToken: string): Promise<{
+        id: string;
+        email?: string | undefined;
+        metadata: Record<string, unknown>;
+    } | null>;
+}
+export interface SSLProvider {
+    /** Provision a certificate for a domain */
+    provision(domain: string): Promise<{
+        status: "provisioning" | "active" | "error";
+        message?: string | undefined;
+    }>;
+    /** Check certificate status */
+    checkStatus(domain: string): Promise<{
+        status: "provisioning" | "active" | "expired" | "error";
+        expiresAt?: Date | undefined;
+    }>;
+    /** Renew a certificate */
+    renew(domain: string): Promise<{
+        status: string;
+    }>;
+}
+export interface WidgetDefinition {
+    /** Unique widget name (e.g., "color-picker", "markdown-editor", "rating-stars") */
+    name: string;
+    /** Human-readable label */
+    label: string;
+    /** Compatible field types this widget can be assigned to (e.g., ["text", "varchar"]) */
+    compatibleTypes: string[];
+    /** Path to React component (relative to plugin package root) */
+    componentPath: string;
+    /** Optional widget configuration schema */
+    configSchema?: Record<string, {
+        type: "string" | "number" | "boolean" | "select";
+        label: string;
+        default?: unknown | undefined;
+    }> | undefined;
+    /** Plugin metadata */
+    meta?: PluginMeta | undefined;
+}
+/** Props passed to widget React components */
+export interface WidgetProps<TValue = unknown> {
+    value: TValue | null;
+    onChange: (value: TValue | null) => void;
+    fieldName: string;
+    fieldType: string;
+    config: Record<string, unknown>;
+    errors: string[];
+    disabled?: boolean | undefined;
+    placeholder?: string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,13 @@
+/**
+ * Core plugin system types for @supatype/plugin-sdk.
+ *
+ * Every Supatype plugin is an npm package that exports one or more of:
+ *   - Field type definitions (defineFieldType)
+ *   - Composite definitions (defineComposite)
+ *   - Provider implementations (defineProvider)
+ *   - Widget definitions (defineWidget)
+ */
+// ─── Plugin Metadata ─────────────────────────────────────────────────────────
+/** Plugin API version — used for compatibility checking. */
+export const PLUGIN_API_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gFAAgF;AAEhF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAA"}