@kb-labs/marketplace-registry-contracts 2.96.0

package/README.md

@@ -0,0 +1,5 @@
+# @kb-labs/marketplace-registry-contracts
+
+> Part of [KB Labs](https://github.com/KirillBaranov/kb-labs) ecosystem.
+
+Public types and schemas for the marketplace registry plugin.

package/dist/index.d.ts

@@ -0,0 +1,129 @@
+import { EntityKind, EntitySignature } from '@kb-labs/core-discovery';
+
+/**
+ * @module @kb-labs/marketplace-registry-contracts
+ * Shared types for the KB Labs Marketplace Registry.
+ */
+
+interface PackageAuthor {
+    name: string;
+    email?: string;
+    url?: string;
+}
+interface PackageRepository {
+    type: string;
+    url: string;
+}
+/** Fields read from package.json and stored in the registry. */
+interface PackageMeta {
+    name: string;
+    version: string;
+    description?: string;
+    author?: PackageAuthor | string;
+    repository?: PackageRepository | string;
+    keywords?: string[];
+    license?: string;
+    homepage?: string;
+    /** README.md content captured at publish time (markdown). */
+    readme?: string;
+    /** Permissions declared in kb.manifest.permissions. */
+    permissions?: string[];
+    /** Environment variables declared in kb.manifest.envVars. */
+    envVars?: string[];
+    /** Allowed network hosts declared in kb.manifest.allowedHosts. */
+    allowedHosts?: string[];
+    /** CLI command IDs registered by the plugin. */
+    commands?: string[];
+}
+type RegistryVisibility = 'public' | 'private';
+type RegistryTrust = 'trusted' | 'untrusted';
+interface RegistryVersionEntry {
+    version: string;
+    publishedAt: string;
+    /** SRI integrity hash of the tarball */
+    integrity: string;
+    /** Platform signature (present for trusted/public packages) */
+    signature?: EntitySignature;
+    yanked?: boolean;
+    yankReason?: string;
+}
+interface RegistryEntry {
+    /** Package name (from package.json) */
+    name: string;
+    /** Author handle (e.g. "kirill") */
+    authorHandle: string;
+    /** Primary entity kind declared at publish time */
+    primaryKind: EntityKind;
+    /** Author namespaceId (from gateway auth) */
+    authorNamespaceId: string;
+    /** Visibility: public (listed in catalog) or private (allowlist only) */
+    visibility: RegistryVisibility;
+    /** Trust level: trusted = signed by KB Labs Platform */
+    trust: RegistryTrust;
+    /** namespaceIds allowed to install (private packages) */
+    allowlist: string[];
+    /** All published versions */
+    versions: RegistryVersionEntry[];
+    /** Whether the package is archived (deprecated) */
+    deprecated: boolean;
+    deprecateMessage?: string;
+    /** Discoverable in catalog and search */
+    featured: boolean;
+    /** Badges (e.g. 'beta-contributor') */
+    badges: string[];
+    /** Tags for filtering */
+    tags: string[];
+    /** Metadata from latest version's package.json */
+    meta: PackageMeta;
+    createdAt: string;
+    updatedAt: string;
+}
+interface PublishRequest {
+    /** package.json metadata */
+    meta: PackageMeta;
+    visibility: RegistryVisibility;
+    /** Primary entity kind (plugin, adapter, studio-widget, …) */
+    primaryKind: EntityKind;
+}
+interface PublishResponse {
+    handle: string;
+    name: string;
+    version: string;
+    visibility: RegistryVisibility;
+    trust: RegistryTrust;
+    signature?: EntitySignature;
+    installCommand: string;
+    pageUrl?: string;
+}
+interface ShareToken {
+    token: string;
+    pkg: string;
+    expiresAt: string;
+}
+interface RegistryPackageSummary {
+    handle: string;
+    name: string;
+    fullName: string;
+    version: string;
+    description?: string;
+    author?: PackageAuthor | string;
+    keywords?: string[];
+    primaryKind: EntityKind;
+    featured: boolean;
+    badges: string[];
+    trust: RegistryTrust;
+    installs: number;
+    publishedAt: string;
+}
+interface RegistryConfig {
+    url: string;
+    publishKey?: string;
+    /** Embedded Ed25519 public key for signature verification (bundled at build time) */
+    signingPublicKey?: string;
+}
+interface PackageStats {
+    installs: number;
+}
+type RegistryErrorCode = 'PACKAGE_NOT_FOUND' | 'VERSION_NOT_FOUND' | 'VERSION_ALREADY_EXISTS' | 'VERSION_YANKED' | 'PACKAGE_DEPRECATED' | 'ACCESS_DENIED' | 'HANDLE_NOT_FOUND' | 'SIGNATURE_INVALID' | 'TARBALL_TOO_LARGE' | (string & {});
+
+export type { PackageAuthor, PackageMeta, PackageRepository, PackageStats, PublishRequest, PublishResponse, RegistryConfig, RegistryEntry, RegistryErrorCode, RegistryPackageSummary, RegistryTrust, RegistryVersionEntry, RegistryVisibility, ShareToken };

package/dist/index.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@kb-labs/marketplace-registry-contracts",
+  "description": "Shared types and interfaces for KB Labs Marketplace Registry",
+  "version": "2.96.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@kb-labs/core-discovery": "2.96.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5",
+    "vitest": "^3.2.6",
+    "@kb-labs/devkit": "2.96.0"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "dev": "tsup --watch",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "test": "vitest run --passWithNoTests -c ../../vitest.config.ts",
+    "test:watch": "vitest -c ../../vitest.config.ts",
+    "type-check": "tsc --noEmit"
+  }
+}