@plumix/core 0.1.0

package/dist/plugin/define.d.ts

@@ -0,0 +1,77 @@
+import type { PluginProvidesContext } from "./provides-context.js";
+import type { PluginSetupContext } from "./setup-context.js";
+export type PluginSetup<TConfig> = (ctx: PluginSetupContext, config: TConfig) => void | Promise<void>;
+export type PluginProvides = (ctx: PluginProvidesContext) => void | Promise<void>;
+export interface PluginI18nSlot {
+    /** Source locale every msgid is authored in. Mirrors lingui.config
+     *  but lives on the manifest so admin can resolve plugin catalog
+     *  paths without re-parsing the plugin's lingui config at runtime. */
+    readonly sourceLocale: string;
+    /** Locales the plugin ships catalogs for. Intersected with the
+     *  site's enabled locales before any URL is generated — declaring
+     *  more locales than the site enables doesn't expand the dropdown. */
+    readonly locales: readonly string[];
+    /** Directory containing the compiled `<locale>.mjs` catalogs,
+     *  relative to the plugin's package root. Admin (via slice 17
+     *  #697) resolves and lazy-loads catalogs from here. Workspace
+     *  plugins' catalogs are baked into the admin bundle via
+     *  `import.meta.glob`; third-party plugins are reached via the
+     *  manifest's `pluginI18n[id].catalogs[locale]` URL. */
+    readonly catalogPath: string;
+}
+export interface PluginDescriptor<TConfig = undefined> {
+    readonly id: string;
+    readonly version?: string;
+    readonly provides?: PluginProvides;
+    readonly setup: PluginSetup<TConfig>;
+    readonly schema?: Record<string, unknown>;
+    readonly schemaModule?: string;
+    /** Translation catalog declaration — opts the plugin into the i18n
+     *  pipeline. Omit to keep all labels rendered as their authored
+     *  strings (no translation lookup, no catalog discovery). */
+    readonly i18n?: PluginI18nSlot;
+    /**
+     * Path to the plugin's admin entry — a TypeScript/TSX module that
+     * imports React from the bare specifier and registers components via
+     * `window.plumix.registerPluginPage(...)`. Resolved relative to the
+     * consumer site's root. The plumix vite plugin assembles every
+     * declared `adminEntry` into a single per-site bundle with `react`,
+     * `react-dom`, `@tanstack/*` aliased to host-shared shims.
+     */
+    readonly adminEntry?: string;
+    /** Pre-built admin chunk path. Legacy alternative to `adminEntry` —
+     *  prefer source for the alias seam. */
+    readonly adminChunk?: string;
+    readonly adminCss?: string;
+    readonly adminPeerVersion?: string;
+    /**
+     * Browser-safe module specifier whose **default export** is the plugin's
+     * `readonly BlockSpec[]` (the same specs `setup` registers). The plumix vite
+     * plugin imports every declared module into the generated editor entry so the
+     * iframe canvas can render — and edit — this plugin's blocks. The module must
+     * not pull server-only code (RPC routes, upload handlers, `definePlugin`); a
+     * dedicated `"<package>/blocks"` subpath is the convention.
+     */
+    readonly editorBlocksModule?: string;
+}
+export interface DefinePluginOptions {
+    readonly version?: string;
+    readonly schema?: Record<string, unknown>;
+    readonly schemaModule?: string;
+    readonly adminEntry?: string;
+    readonly adminChunk?: string;
+    readonly adminCss?: string;
+    readonly adminPeerVersion?: string;
+    readonly editorBlocksModule?: string;
+    readonly i18n?: PluginI18nSlot;
+}
+export interface DefinePluginInput<TConfig> extends DefinePluginOptions {
+    readonly provides?: PluginProvides;
+    readonly setup: PluginSetup<TConfig>;
+}
+export declare const PLUGIN_ID_RE: RegExp;
+export declare const MAX_PLUGIN_ID_LENGTH = 64;
+export declare function assertValidPluginId(id: string): void;
+export declare function definePlugin<TConfig = undefined>(id: string, setup: PluginSetup<TConfig>, options?: DefinePluginOptions): PluginDescriptor<TConfig>;
+export declare function definePlugin<TConfig = undefined>(id: string, input: DefinePluginInput<TConfig>): PluginDescriptor<TConfig>;
+//# sourceMappingURL=define.d.ts.map

package/dist/plugin/define.d.ts.map

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

package/dist/plugin/define.js

@@ -0,0 +1,74 @@
+import { PluginDefinitionError } from "./errors.js";
+// URL- and SQL-identifier-safe — plugin ids become path segments,
+// RPC namespace keys, and nav-group ids without quoting.
+export const PLUGIN_ID_RE = /^[a-z][a-z0-9_-]*$/;
+export const MAX_PLUGIN_ID_LENGTH = 64;
+export function assertValidPluginId(id) {
+    if (id.length === 0 || id.length > MAX_PLUGIN_ID_LENGTH) {
+        throw PluginDefinitionError.invalidPluginIdLength({
+            pluginId: id,
+            pluginIdMaxLength: MAX_PLUGIN_ID_LENGTH,
+        });
+    }
+    if (!PLUGIN_ID_RE.test(id)) {
+        throw PluginDefinitionError.invalidPluginIdShape({
+            pluginId: id,
+            pattern: PLUGIN_ID_RE.source,
+        });
+    }
+}
+export function definePlugin(id, setupOrInput, legacyOptions) {
+    assertValidPluginId(id);
+    if (typeof setupOrInput === "function") {
+        warnIfSchemaWithoutSchemaModule(id, legacyOptions);
+        return {
+            id,
+            version: legacyOptions?.version,
+            setup: setupOrInput,
+            schema: legacyOptions?.schema,
+            schemaModule: legacyOptions?.schemaModule,
+            adminEntry: legacyOptions?.adminEntry,
+            adminChunk: legacyOptions?.adminChunk,
+            adminCss: legacyOptions?.adminCss,
+            adminPeerVersion: legacyOptions?.adminPeerVersion,
+            editorBlocksModule: legacyOptions?.editorBlocksModule,
+            i18n: legacyOptions?.i18n,
+        };
+    }
+    if (legacyOptions !== undefined) {
+        throw PluginDefinitionError.definePluginLegacyThirdArg({ pluginId: id });
+    }
+    warnIfSchemaWithoutSchemaModule(id, setupOrInput);
+    return {
+        id,
+        version: setupOrInput.version,
+        provides: setupOrInput.provides,
+        setup: setupOrInput.setup,
+        schema: setupOrInput.schema,
+        schemaModule: setupOrInput.schemaModule,
+        adminEntry: setupOrInput.adminEntry,
+        adminChunk: setupOrInput.adminChunk,
+        adminCss: setupOrInput.adminCss,
+        adminPeerVersion: setupOrInput.adminPeerVersion,
+        editorBlocksModule: setupOrInput.editorBlocksModule,
+        i18n: setupOrInput.i18n,
+    };
+}
+// Per-id dedup so a plugin defined twice (re-imports, HMR, repeat
+// build entries) only emits the warning once.
+const warnedIds = new Set();
+function warnIfSchemaWithoutSchemaModule(id, opts) {
+    if (!opts?.schema || opts.schemaModule)
+        return;
+    if (warnedIds.has(id))
+        return;
+    warnedIds.add(id);
+    console.warn(`[plumix] plugin "${id}" declares \`schema\` but not ` +
+        `\`schemaModule\`. Runtime queries will work, but ` +
+        `\`plumix migrate generate\` won't include this plugin's tables ` +
+        `in the generated migrations — you'll hit "no such table" the ` +
+        `first time a query runs. Add ` +
+        `\`schemaModule: "<package>/schema"\` and export the matching ` +
+        `subpath.`);
+}
+//# sourceMappingURL=define.js.map

package/dist/plugin/define.js.map

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

package/dist/plugin/errors.d.ts

@@ -0,0 +1,265 @@
+type PluginContextErrorCode = "duplicate_route" | "extend_context_invalid_key" | "extend_context_reserved_key" | "extend_app_context_builtin_collision" | "extend_context_duplicate" | "derived_capability_min_role_mismatch" | "settings_page_duplicate_group" | "plugin_id_collides_with_core_rpc_namespace" | "extension_shadows_builtin" | "invalid_component_ref" | "invalid_field_type_name" | "invalid_lookup_adapter_kind" | "invalid_scheduled_task_id" | "scheduled_task_handler_missing" | "invalid_login_link_key" | "login_link_empty_label" | "login_link_label_has_crlf" | "invalid_login_link_href" | "invalid_nav_group_id_length" | "invalid_nav_group_id_shape" | "path_must_start_with_slash" | "path_contains_traversal" | "path_contains_query_or_fragment" | "admin_page_path_contains_wildcard" | "route_path_wildcard_not_at_end" | "route_path_wildcard_not_after_slash" | "identifier_too_long" | "identifier_shape_invalid" | "identifier_namespace_mismatch" | "meta_box_too_many_fields" | "meta_box_field_invalid_key" | "meta_box_field_duplicate_key" | "meta_box_field_reserved_key" | "template_dep_kind_reserved";
+export declare class PluginContextError extends Error {
+    readonly code: PluginContextErrorCode;
+    readonly pluginId: string | undefined;
+    readonly kind: string | undefined;
+    readonly key: string | undefined;
+    readonly path: string | undefined;
+    readonly identifierName: string | undefined;
+    readonly id: string | undefined;
+    readonly type: string | undefined;
+    readonly href: string | undefined;
+    readonly descriptor: string | undefined;
+    readonly existingOwner: string | undefined;
+    readonly capName: string | undefined;
+    readonly minRole: string | undefined;
+    readonly existingMinRole: string | undefined;
+    readonly fieldKey: string | undefined;
+    readonly pattern: string | undefined;
+    readonly count: number | undefined;
+    readonly maxLength: number | undefined;
+    readonly maxFields: number | undefined;
+    readonly coreNamespaces: readonly string[] | undefined;
+    private constructor();
+    static duplicateRoute(ctx: {
+        pluginId: string;
+        method: string;
+        path: string;
+    }): PluginContextError;
+    static extendContextInvalidKey(ctx: {
+        pluginId: string;
+        kind: "Plugin" | "App";
+    }): PluginContextError;
+    static extendContextReservedKey(ctx: {
+        pluginId: string;
+        kind: "Plugin" | "App";
+        key: string;
+    }): PluginContextError;
+    static extendAppContextBuiltinCollision(ctx: {
+        pluginId: string;
+        key: string;
+    }): PluginContextError;
+    static extendContextDuplicate(ctx: {
+        pluginId: string;
+        kind: "Plugin" | "App";
+        key: string;
+        existingOwner: string;
+    }): PluginContextError;
+    static derivedCapabilityMinRoleMismatch(ctx: {
+        pluginId: string;
+        capName: string;
+        minRole: string;
+        existingMinRole: string;
+        existingOwner: string;
+    }): PluginContextError;
+    static settingsPageDuplicateGroup(ctx: {
+        name: string;
+    }): PluginContextError;
+    static templateDepKindReserved(ctx: {
+        pluginId: string;
+        kind: string;
+    }): PluginContextError;
+    static pluginIdCollidesWithCoreRpcNamespace(ctx: {
+        pluginId: string;
+        coreNamespaces: readonly string[];
+    }): PluginContextError;
+    static extensionShadowsBuiltin(ctx: {
+        key: string;
+    }): PluginContextError;
+    static invalidComponentRef(ctx: {
+        pluginId: string;
+        descriptor: string;
+    }): PluginContextError;
+    static invalidFieldTypeName(ctx: {
+        pluginId: string;
+        type: string;
+        pattern: string;
+        maxLength: number;
+    }): PluginContextError;
+    static invalidLookupAdapterKind(ctx: {
+        pluginId: string;
+        kind: string;
+        pattern: string;
+        maxLength: number;
+    }): PluginContextError;
+    static invalidScheduledTaskId(ctx: {
+        pluginId: string;
+        id: string;
+    }): PluginContextError;
+    static scheduledTaskHandlerMissing(ctx: {
+        pluginId: string;
+        id: string;
+    }): PluginContextError;
+    static invalidLoginLinkKey(ctx: {
+        pluginId: string;
+        key: string;
+    }): PluginContextError;
+    static loginLinkEmptyLabel(ctx: {
+        pluginId: string;
+        key: string;
+    }): PluginContextError;
+    static loginLinkLabelHasCrLf(ctx: {
+        pluginId: string;
+        key: string;
+    }): PluginContextError;
+    static invalidLoginLinkHref(ctx: {
+        pluginId: string;
+        key: string;
+        href: string;
+    }): PluginContextError;
+    static invalidNavGroupIdLength(ctx: {
+        pluginId: string;
+        id: string;
+        maxLength: number;
+    }): PluginContextError;
+    static invalidNavGroupIdShape(ctx: {
+        pluginId: string;
+        id: string;
+        pattern: string;
+    }): PluginContextError;
+    static pathMustStartWithSlash(ctx: {
+        pluginId: string;
+        kind: string;
+        path: string;
+    }): PluginContextError;
+    static pathContainsTraversal(ctx: {
+        pluginId: string;
+        kind: string;
+        path: string;
+    }): PluginContextError;
+    static pathContainsQueryOrFragment(ctx: {
+        pluginId: string;
+        kind: string;
+        path: string;
+    }): PluginContextError;
+    static adminPagePathContainsWildcard(ctx: {
+        pluginId: string;
+        path: string;
+    }): PluginContextError;
+    static routePathWildcardNotAtEnd(ctx: {
+        pluginId: string;
+        path: string;
+    }): PluginContextError;
+    static routePathWildcardNotAfterSlash(ctx: {
+        pluginId: string;
+        path: string;
+    }): PluginContextError;
+    static identifierTooLong(ctx: {
+        kind: string;
+        name: string;
+        maxLength: number;
+    }): PluginContextError;
+    static identifierShapeInvalid(ctx: {
+        kind: string;
+        name: string;
+        pattern: string;
+    }): PluginContextError;
+    static identifierNamespaceMismatch(ctx: {
+        kind: string;
+        name: string;
+        pluginId: string;
+    }): PluginContextError;
+    static metaBoxTooManyFields(ctx: {
+        kind: string;
+        id: string;
+        count: number;
+        maxFields: number;
+    }): PluginContextError;
+    static metaBoxFieldInvalidKey(ctx: {
+        kind: string;
+        id: string;
+        fieldKey: string;
+        pattern: string;
+    }): PluginContextError;
+    static metaBoxFieldDuplicateKey(ctx: {
+        kind: string;
+        id: string;
+        fieldKey: string;
+    }): PluginContextError;
+    static metaBoxFieldReservedKey(ctx: {
+        kind: string;
+        id: string;
+        fieldKey: string;
+    }): PluginContextError;
+}
+type PluginDefinitionErrorCode = "invalid_plugin_id_length" | "invalid_plugin_id_shape" | "define_plugin_legacy_third_arg" | "duplicate_plugin_id_in_config" | "meta_field_clash_across_boxes" | "meta_box_references_unknown_scope" | "settings_page_references_unknown_group" | "admin_slug_derivation_failed" | "admin_manifest_placeholder_missing";
+export declare class PluginDefinitionError extends Error {
+    readonly code: PluginDefinitionErrorCode;
+    readonly pluginId: string | undefined;
+    readonly pluginIdMaxLength: number | undefined;
+    readonly pattern: string | undefined;
+    readonly kind: string | undefined;
+    readonly fieldKey: string | undefined;
+    readonly firstBoxId: string | undefined;
+    readonly secondBoxId: string | undefined;
+    readonly scope: string | undefined;
+    readonly boxKind: string | undefined;
+    readonly boxId: string | undefined;
+    readonly scopeKind: string | undefined;
+    readonly pageName: string | undefined;
+    readonly groupName: string | undefined;
+    readonly entryTypeName: string | undefined;
+    readonly from: string | undefined;
+    readonly scriptId: string | undefined;
+    private constructor();
+    static invalidPluginIdLength(ctx: {
+        pluginId: string;
+        pluginIdMaxLength: number;
+    }): PluginDefinitionError;
+    static invalidPluginIdShape(ctx: {
+        pluginId: string;
+        pattern: string;
+    }): PluginDefinitionError;
+    static definePluginLegacyThirdArg(ctx: {
+        pluginId: string;
+    }): PluginDefinitionError;
+    static duplicatePluginIdInConfig(ctx: {
+        pluginId: string;
+    }): PluginDefinitionError;
+    static metaFieldClashAcrossBoxes(ctx: {
+        kind: string;
+        fieldKey: string;
+        firstBoxId: string;
+        secondBoxId: string;
+        scope: string;
+    }): PluginDefinitionError;
+    static metaBoxReferencesUnknownScope(ctx: {
+        boxKind: string;
+        boxId: string;
+        scopeKind: string;
+        scope: string;
+    }): PluginDefinitionError;
+    static settingsPageReferencesUnknownGroup(ctx: {
+        pageName: string;
+        groupName: string;
+    }): PluginDefinitionError;
+    static adminSlugDerivationFailed(ctx: {
+        entryTypeName: string;
+        from: string;
+    }): PluginDefinitionError;
+    static adminManifestPlaceholderMissing(ctx: {
+        scriptId: string;
+    }): PluginDefinitionError;
+}
+export declare class DuplicateRegistrationError extends Error {
+    readonly kind: string;
+    readonly identifier: string;
+    private constructor();
+    static alreadyRegistered(ctx: {
+        kind: string;
+        identifier: string;
+    }): DuplicateRegistrationError;
+}
+export declare class DuplicateAdminSlugError extends Error {
+    readonly firstPostType: string;
+    readonly secondPostType: string;
+    readonly slug: string;
+    private constructor();
+    static slugCollision(ctx: {
+        firstPostType: string;
+        secondPostType: string;
+        slug: string;
+    }): DuplicateAdminSlugError;
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/plugin/errors.d.ts.map

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