@camerontaylor/paseo-protocol 0.11.0-beta.3.fork.1 → 0.11.1-fork.2

package/dist/plugin-overview.js

@@ -0,0 +1,50 @@
+/** Presentation contract for author-controlled registry content, independent of the UI runtime. */
+export const pluginOverviewPolicy = {
+    rawHtml: false,
+    elements: [
+        "p",
+        "br",
+        "hr",
+        "h1",
+        "h2",
+        "h3",
+        "h4",
+        "h5",
+        "h6",
+        "blockquote",
+        "ul",
+        "ol",
+        "li",
+        "strong",
+        "em",
+        "del",
+        "pre",
+        "code",
+        "a",
+        "img",
+        "table",
+        "thead",
+        "tbody",
+        "tr",
+        "th",
+        "td",
+    ],
+    link: { rel: "noopener noreferrer nofollow", target: "_blank" },
+};
+/** Validate decoded Markdown destinations; never resolve against the reader's page or repository. */
+export function pluginOverviewUrl(value) {
+    // URL parsers discard controls and normalize backslashes; reject those ambiguous spellings.
+    // eslint-disable-next-line no-control-regex
+    if (!value || !/^https:\/\/[^/?#]/i.test(value) || /[\u0000-\u0020\u007f\\]/.test(value))
+        return undefined;
+    try {
+        const url = new URL(value);
+        if (url.protocol !== "https:" || !url.hostname || url.username || url.password)
+            return undefined;
+        return value;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=plugin-overview.js.map

package/dist/plugin-registry.d.ts

@@ -0,0 +1,147 @@
+import { z } from "zod";
+export declare const PluginRegistryIdSchema: z.ZodString;
+export declare const PluginRegistryIdentitySchema: z.ZodObject<{
+    url: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strip>;
+export declare const PluginRegistriesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    authorization: z.ZodString;
+}, z.core.$strip>>;
+export declare const PluginRegistryArtifactSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"npm">;
+    package: z.ZodString;
+    version: z.ZodString;
+    resolved: z.ZodString;
+    integrity: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"git">;
+    remote: z.ZodString;
+    commit: z.ZodString;
+    pluginPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">;
+export declare const PublishedPluginSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    license: z.ZodOptional<z.ZodString>;
+    categories: z.ZodArray<z.ZodString>;
+    author: z.ZodObject<{
+        github: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        npm: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    repository: z.ZodObject<{
+        url: z.ZodString;
+        commit: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    artifact: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"npm">;
+        package: z.ZodString;
+        version: z.ZodString;
+        resolved: z.ZodString;
+        integrity: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"git">;
+        remote: z.ZodString;
+        commit: z.ZodString;
+        pluginPath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "kind">;
+    icon: z.ZodOptional<z.ZodString>;
+    media: z.ZodArray<z.ZodString>;
+    submittedAt: z.ZodString;
+    reviewedAt: z.ZodString;
+    updatedAt: z.ZodString;
+    publishedAt: z.ZodString;
+    installs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Whether a registry media entry is a video or an image, from its path extension. */
+export declare function pluginMediaKind(url: string): "image" | "video";
+export declare const PublishedPluginDetailSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    license: z.ZodOptional<z.ZodString>;
+    categories: z.ZodArray<z.ZodString>;
+    author: z.ZodObject<{
+        github: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        npm: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    repository: z.ZodObject<{
+        url: z.ZodString;
+        commit: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    artifact: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"npm">;
+        package: z.ZodString;
+        version: z.ZodString;
+        resolved: z.ZodString;
+        integrity: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"git">;
+        remote: z.ZodString;
+        commit: z.ZodString;
+        pluginPath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "kind">;
+    icon: z.ZodOptional<z.ZodString>;
+    media: z.ZodArray<z.ZodString>;
+    submittedAt: z.ZodString;
+    reviewedAt: z.ZodString;
+    updatedAt: z.ZodString;
+    publishedAt: z.ZodString;
+    installs: z.ZodOptional<z.ZodNumber>;
+    readme: z.ZodString;
+}, z.core.$strip>;
+export declare const PluginRegistryIndexSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    registry: z.ZodObject<{
+        name: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strip>;
+    categories: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    plugins: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodString;
+        license: z.ZodOptional<z.ZodString>;
+        categories: z.ZodArray<z.ZodString>;
+        author: z.ZodObject<{
+            github: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            npm: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        repository: z.ZodObject<{
+            url: z.ZodString;
+            commit: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        artifact: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"npm">;
+            package: z.ZodString;
+            version: z.ZodString;
+            resolved: z.ZodString;
+            integrity: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"git">;
+            remote: z.ZodString;
+            commit: z.ZodString;
+            pluginPath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "kind">;
+        icon: z.ZodOptional<z.ZodString>;
+        media: z.ZodArray<z.ZodString>;
+        submittedAt: z.ZodString;
+        reviewedAt: z.ZodString;
+        updatedAt: z.ZodString;
+        publishedAt: z.ZodString;
+        installs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    featured: z.ZodArray<z.ZodString>;
+    generatedAt: z.ZodString;
+}, z.core.$strip>;
+export type PluginRegistryIdentity = z.infer<typeof PluginRegistryIdentitySchema>;
+export type PluginRegistries = z.infer<typeof PluginRegistriesSchema>;
+export declare function parsePluginRegistryReference(source: string, defaultUrl?: string): PluginRegistryIdentity | null;
+//# sourceMappingURL=plugin-registry.d.ts.map

package/dist/plugin-registry.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+export const PluginRegistryIdSchema = z
+    .string()
+    .regex(/^[a-z0-9]+(?:-[a-z0-9]+)*\/[a-z0-9]+(?:-[a-z0-9]+)*$/);
+export const PluginRegistryIdentitySchema = z.object({
+    url: z.string().url(),
+    id: PluginRegistryIdSchema,
+});
+export const PluginRegistriesSchema = z.record(z.string(), z.object({ authorization: z.string().min(1) }));
+export const PluginRegistryArtifactSchema = z.discriminatedUnion("kind", [
+    z.object({
+        kind: z.literal("npm"),
+        package: z.string().regex(/^(?:@[a-z0-9][\w.-]*\/)?[a-z0-9][\w.-]*$/),
+        version: z.string().regex(/^\d+\.\d+\.\d+(?:-[\w.-]+)?(?:\+[\w.-]+)?$/),
+        resolved: z.string().url(),
+        integrity: z.string().regex(/^sha512-[A-Za-z0-9+/]+=*$/),
+    }),
+    z.object({
+        kind: z.literal("git"),
+        remote: z.string().min(1),
+        commit: z.string().regex(/^[0-9a-f]{40,64}$/),
+        pluginPath: z
+            .string()
+            .regex(/^[^\\:]+$/)
+            .optional(),
+    }),
+]);
+export const PublishedPluginSchema = z.object({
+    id: PluginRegistryIdSchema,
+    name: z.string(),
+    description: z.string(),
+    license: z.string().optional(),
+    categories: z.array(z.string()),
+    author: z.object({ github: z.string(), name: z.string().optional(), npm: z.string().optional() }),
+    repository: z.object({ url: z.string().url(), commit: z.string().optional() }),
+    artifact: PluginRegistryArtifactSchema,
+    icon: z.string().url().optional(),
+    /** Images and videos in display order; see `pluginMediaKind`. */
+    media: z.array(z.string().url()),
+    submittedAt: z.string(),
+    reviewedAt: z.string(),
+    updatedAt: z.string(),
+    publishedAt: z.string(),
+    installs: z.number().int().nonnegative().optional(),
+});
+const VIDEO_EXTENSIONS = new Set(["mp4", "webm"]);
+/** Whether a registry media entry is a video or an image, from its path extension. */
+export function pluginMediaKind(url) {
+    const extension = new URL(url).pathname.split(".").pop()?.toLowerCase() ?? "";
+    return VIDEO_EXTENSIONS.has(extension) ? "video" : "image";
+}
+export const PublishedPluginDetailSchema = PublishedPluginSchema.extend({ readme: z.string() });
+export const PluginRegistryIndexSchema = z.object({
+    schemaVersion: z.literal(1),
+    registry: z.object({ name: z.string(), url: z.string().url() }),
+    categories: z.array(z.object({ slug: z.string(), label: z.string(), description: z.string().optional() })),
+    plugins: z.array(PublishedPluginSchema),
+    /** Plugin IDs the maintainer features, in display order. An ID may name a plugin that is not listed. */
+    featured: z.array(z.string()),
+    generatedAt: z.string(),
+});
+export function parsePluginRegistryReference(source, defaultUrl = "https://plugins.paseo.sh") {
+    const segments = source.split("/");
+    if (segments.length === 2 && PluginRegistryIdSchema.safeParse(source).success)
+        return { url: defaultUrl.replace(/\/+$/, ""), id: source };
+    const [host, ...rest] = segments;
+    if (segments.length !== 3 || !host || !/[.:]/.test(host) || /[@?#\\]/.test(host))
+        return null;
+    const id = rest.join("/");
+    if (!PluginRegistryIdSchema.safeParse(id).success)
+        return null;
+    const url = new URL(`https://${host}`);
+    return { url: url.origin, id };
+}
+//# sourceMappingURL=plugin-registry.js.map

package/dist/plugin-source-reference.d.ts

@@ -1,5 +1,6 @@
 import type { PluginInstallation } from "./messages.js";
 export interface PluginSourceReference {
+    kind: "directory" | "managed";
     source: string;
     pluginPath: string | undefined;
 }

package/dist/plugin-source-reference.js

@@ -1,8 +1,14 @@
+import { parsePluginRegistryReference } from "./plugin-registry.js";
 export function parsePluginSourceReference(reference) {
     const prefix = /^(npm:|github:|git:(?!\/\/))/.exec(reference)?.[0];
     const source = prefix ? reference.slice(prefix.length) : reference;
     const parsed = splitPluginPath(source, { scp: prefix !== "npm:" });
-    return { ...parsed, source: `${prefix ?? ""}${parsed.source}` };
+    if (!prefix && /^(\.\.?(?:[/\\]|$)|\/|~|[A-Za-z]:[/\\]|\\\\)/.test(parsed.source)) {
+        return { kind: "directory", ...parsed };
+    }
+    if (parsePluginRegistryReference(reference))
+        return { kind: "managed", source: reference, pluginPath: undefined };
+    return { kind: "managed", ...parsed, source: `${prefix ?? ""}${parsed.source}` };
 }
 function splitPluginPath(reference, options) {
     const separator = reference.lastIndexOf(":");
@@ -47,6 +53,8 @@ function isPortableRelativePluginPath(pluginPath) {
 export function formatPluginIdentity(identity) {
     if (identity.kind === "directory")
         return identity.path;
+    if (identity.registry)
+        return `${new URL(identity.registry.url).host}/${identity.registry.id}`;
     const source = identity.kind === "npm" ? `npm:${identity.packageName}` : `git:${identity.remote}`;
     return identity.pluginPath === "." ? source : `${source}:${identity.pluginPath}`;
 }

package/dist/schedule/rpc-schemas.d.ts

@@ -112,13 +112,13 @@ export declare const ScheduleCreateResponseSchema: z.ZodObject<{
         schedule: z.ZodNullable<z.ZodObject<{
             name: z.ZodNullable<z.ZodString>;
             id: z.ZodString;
+            updatedAt: z.ZodString;
             status: z.ZodEnum<{
                 completed: "completed";
                 active: "active";
                 paused: "paused";
             }>;
             createdAt: z.ZodString;
-            updatedAt: z.ZodString;
             cadence: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"every">;
                 everyMs: z.ZodNumber;
@@ -167,13 +167,13 @@ export declare const ScheduleListResponseSchema: z.ZodObject<{
         schedules: z.ZodArray<z.ZodObject<{
             name: z.ZodNullable<z.ZodString>;
             id: z.ZodString;
+            updatedAt: z.ZodString;
             status: z.ZodEnum<{
                 completed: "completed";
                 active: "active";
                 paused: "paused";
             }>;
             createdAt: z.ZodString;
-            updatedAt: z.ZodString;
             cadence: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"every">;
                 everyMs: z.ZodNumber;
@@ -314,13 +314,13 @@ export declare const SchedulePauseResponseSchema: z.ZodObject<{
         schedule: z.ZodNullable<z.ZodObject<{
             name: z.ZodNullable<z.ZodString>;
             id: z.ZodString;
+            updatedAt: z.ZodString;
             status: z.ZodEnum<{
                 completed: "completed";
                 active: "active";
                 paused: "paused";
             }>;
             createdAt: z.ZodString;
-            updatedAt: z.ZodString;
             cadence: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"every">;
                 everyMs: z.ZodNumber;
@@ -369,13 +369,13 @@ export declare const ScheduleResumeResponseSchema: z.ZodObject<{
         schedule: z.ZodNullable<z.ZodObject<{
             name: z.ZodNullable<z.ZodString>;
             id: z.ZodString;
+            updatedAt: z.ZodString;
             status: z.ZodEnum<{
                 completed: "completed";
                 active: "active";
                 paused: "paused";
             }>;
             createdAt: z.ZodString;
-            updatedAt: z.ZodString;
             cadence: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"every">;
                 everyMs: z.ZodNumber;

package/dist/schedule/types.d.ts

@@ -121,13 +121,13 @@ export type StoredSchedule = z.infer<typeof StoredScheduleSchema>;
 export declare const ScheduleSummarySchema: z.ZodObject<{
     name: z.ZodNullable<z.ZodString>;
     id: z.ZodString;
+    updatedAt: z.ZodString;
     status: z.ZodEnum<{
         completed: "completed";
         active: "active";
         paused: "paused";
     }>;
     createdAt: z.ZodString;
-    updatedAt: z.ZodString;
     cadence: z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"every">;
         everyMs: z.ZodNumber;