@structured-world/gitlab-mcp 6.5.0 → 6.7.0

package/README.md

@@ -54,6 +54,7 @@ env = { "GITLAB_TOKEN" = "mytoken", "GITLAB_API_URL" = "https://gitlab.com" }
         "USE_PIPELINE": "false", // use pipeline api?
         "USE_VARIABLES": "true", // use variables api?
         "USE_WEBHOOKS": "true", // use webhooks api?
+        "USE_SNIPPETS": "true", // use snippets api?
         "SKIP_TLS_VERIFY": "false" // skip SSL cert verification (dev only)
       }
     }
@@ -123,6 +124,8 @@ env = { "GITLAB_TOKEN" = "mytoken", "GITLAB_API_URL" = "https://gitlab.com" }
         "USE_VARIABLES",
         "-e",
         "USE_WEBHOOKS",
+        "-e",
+        "USE_SNIPPETS",
         "ghcr.io/structured-world/gitlab-mcp:latest"
       ],
       "env": {
@@ -133,7 +136,8 @@ env = { "GITLAB_TOKEN" = "mytoken", "GITLAB_API_URL" = "https://gitlab.com" }
         "USE_MILESTONE": "true",
         "USE_PIPELINE": "true",
         "USE_VARIABLES": "true",
-        "USE_WEBHOOKS": "true"
+        "USE_WEBHOOKS": "true",
+        "USE_SNIPPETS": "true"
       }
     }
   }
@@ -467,9 +471,10 @@ When OAuth is enabled, the following endpoints are available:
 - `USE_LABELS`: When set to 'true', enables the label-related tools (list_labels, get_label, create_label, update_label, delete_label). By default, label features are enabled.
 - `USE_MRS`: When set to 'true', enables the merge request-related tools (browse_merge_requests, browse_mr_discussions, manage_merge_request, manage_mr_discussion, manage_draft_notes). These 5 CQRS tools consolidate all MR operations. By default, merge request features are enabled.
 - `USE_FILES`: When set to 'true', enables the file-related tools (browse_files, manage_files). These 2 CQRS tools consolidate all file operations. By default, file operation features are enabled.
-- `USE_VARIABLES`: When set to 'true', enables the CI/CD variables-related tools (list_variables, get_variable, create_variable, update_variable, delete_variable). Supports both project-level and group-level variables. By default, variables features are enabled.
+- `USE_VARIABLES`: When set to 'true', enables the CI/CD variables-related tools (browse_variables, manage_variable). These 2 CQRS tools consolidate all variable operations. Supports both project-level and group-level variables. By default, variables features are enabled.
 - `USE_WORKITEMS`: When set to 'true', enables the work items-related tools (browse_work_items, manage_work_item). These 2 CQRS tools consolidate all work item operations using GitLab GraphQL API. By default, work items features are enabled.
 - `USE_WEBHOOKS`: When set to 'true', enables the webhooks-related tools (list_webhooks, manage_webhook). These 2 tools provide full CRUD operations plus testing for both project and group webhooks. Group webhooks require GitLab Premium tier. By default, webhooks features are enabled.
+- `USE_SNIPPETS`: When set to 'true', enables the snippets-related tools (list_snippets, manage_snippet). These 2 CQRS tools provide full listing and CRUD operations for both personal and project snippets. Supports multi-file snippets, visibility control, and flexible scoping. By default, snippets features are enabled.
 - `GITLAB_AUTH_COOKIE_PATH`: Path to an authentication cookie file for GitLab instances that require cookie-based authentication. When provided, the cookie will be included in all GitLab API requests.
 - `SKIP_TLS_VERIFY`: When set to 'true', skips TLS certificate verification for all GitLab API requests (both REST and GraphQL). **WARNING**: This bypasses SSL certificate validation and should only be used for testing with self-signed certificates or trusted internal GitLab instances. Never use this in production environments.
 - `SSL_CERT_PATH`: Path to PEM certificate file for direct HTTPS/TLS termination. Requires `SSL_KEY_PATH` to also be set.
@@ -538,11 +543,11 @@ export GITLAB_TOOL_MANAGE_WORK_ITEM="Create and manage tickets for our sprint pl
 - **Case Sensitivity**: Tool names in environment variables must be UPPERCASE (e.g., `LIST_PROJECTS` not `list_projects`)
 - **Invalid Names**: Invalid tool names in environment variables are ignored with a warning in debug logs
 - **Content Guidelines**: Descriptions can be any valid string but should be kept concise for better UX
-- **Scope**: Works with all 58 available tools across all entities (Core, Work Items, Merge Requests, Files, etc.)
+- **Scope**: Works with all 59 available tools across all entities (Core, Work Items, Merge Requests, Files, Snippets, etc.)
 
 ## Tools 🛠️
 
-**60 Tools Available** - Organized by entity and functionality below.
+**59 Tools Available** - Organized by entity and functionality below.
 
 ### Key Features:
 - **CQRS Pattern** - Consolidated action-based tools: `browse_*` for reads, `manage_*` for writes
@@ -614,14 +619,14 @@ Requires USE_FILES=true environment variable (enabled by default). Uses CQRS pat
 - 📖 **`browse_files`**: BROWSE repository files. Actions: "tree" lists files/folders with pagination, "content" reads file contents. Use for exploring project structure or reading source code.
 - ✏️ **`manage_files`**: MANAGE repository files. Actions: "single" creates/updates one file, "batch" commits multiple files atomically, "upload" adds markdown attachments.
 
-### CI/CD Variables (5 tools)
-Requires USE_VARIABLES=true environment variable (enabled by default). Supports both project-level and group-level variables.
+### CI/CD Variables (2 CQRS tools)
+Requires USE_VARIABLES=true environment variable (enabled by default). Uses CQRS pattern with action-based tools. Supports both project-level and group-level variables.
+
+#### Variable Browsing (Query)
+- 📖 **`browse_variables`**: BROWSE CI/CD variables. Actions: "list" shows all variables in project/group with pagination, "get" retrieves single variable details by key with optional environment scope filter.
 
-- 📖 **`list_variables`**: List all CI/CD variables for a project or group with their configuration and security settings
-- 📖 **`get_variable`**: Get a specific CI/CD variable by key from a project or group, optionally filtered by environment scope
-- ✏️ **`create_variable`**: Create a new CI/CD variable for automated deployments and pipeline configuration in a project or group
-- ✏️ **`update_variable`**: Update an existing CI/CD variable's value, security settings, or configuration in a project or group
-- ✏️ **`delete_variable`**: Remove a CI/CD variable from a project or group
+#### Variable Management (Command)
+- ✏️ **`manage_variable`**: MANAGE CI/CD variables. Actions: "create" adds new variable (requires key and value), "update" modifies existing variable, "delete" removes variable permanently. Supports environment scoping and protection settings.
 
 ### Work Items (2 CQRS tools)
 Modern GraphQL API for issues, epics, tasks, and more. Requires USE_WORKITEMS=true (enabled by default). Uses CQRS pattern with action-based tools.
@@ -696,6 +701,20 @@ Webhooks can be configured to trigger on:
 - **Subgroup events** - Subgroup created/removed (group webhooks only)
 - **Project events** - Project created/removed (group webhooks only)
 
+### Snippets Management (2 tools)
+Requires USE_SNIPPETS=true environment variable (enabled by default). Uses CQRS pattern with action-based tools. Supports personal, project, and public snippets with multi-file support.
+
+#### Snippet Browsing (Query)
+- 📖 **`list_snippets`**: LIST GitLab code snippets with flexible scoping. Use scope='personal' for current user's snippets, scope='project' for project-specific snippets (requires projectId), or scope='public' to discover all public snippets. Filter by visibility level (private/internal/public) and creation date. Supports pagination.
+
+#### Snippet Management (Command)
+- ✏️ **`manage_snippet`**: MANAGE GitLab snippets with full CRUD operations via action parameter. Actions: "read" retrieves snippet metadata or raw content, "create" creates new snippet with multiple files and visibility control, "update" modifies title/description/visibility/files (supports file create/update/delete/move actions), "delete" permanently removes snippet. Supports both personal and project snippets.
+
+#### Multi-file Snippet Support
+Snippets can contain multiple files with individual operations:
+- **Create action** - Files array with `file_path` and `content` for each file
+- **Update action** - Files array with `action` field: "create" (add new), "update" (modify existing), "delete" (remove), "move" (rename with `previous_path`)
+
 ## CLI Tools 🔧
 
 ### list-tools - Browse Available Tools

package/dist/src/config.d.ts

@@ -11,6 +11,7 @@ export declare const USE_LABELS: boolean;
 export declare const USE_MRS: boolean;
 export declare const USE_FILES: boolean;
 export declare const USE_VARIABLES: boolean;
+export declare const USE_SNIPPETS: boolean;
 export declare const USE_WEBHOOKS: boolean;
 export declare const HOST: string;
 export declare const PORT: string | number;

package/dist/src/config.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.packageVersion = exports.packageName = exports.GITLAB_ALLOWED_PROJECT_IDS = exports.GITLAB_PROJECT_ID = exports.GITLAB_API_URL = exports.GITLAB_BASE_URL = exports.GITLAB_CA_CERT_PATH = exports.NODE_TLS_REJECT_UNAUTHORIZED = exports.HTTPS_PROXY = exports.HTTP_PROXY = exports.SKIP_TLS_VERIFY = exports.RATE_LIMIT_SESSION_MAX_REQUESTS = exports.RATE_LIMIT_SESSION_WINDOW_MS = exports.RATE_LIMIT_SESSION_ENABLED = exports.RATE_LIMIT_IP_MAX_REQUESTS = exports.RATE_LIMIT_IP_WINDOW_MS = exports.RATE_LIMIT_IP_ENABLED = exports.API_TIMEOUT_MS = exports.TRUST_PROXY = exports.SSL_PASSPHRASE = exports.SSL_CA_PATH = exports.SSL_KEY_PATH = exports.SSL_CERT_PATH = exports.PORT = exports.HOST = exports.USE_WEBHOOKS = exports.USE_VARIABLES = exports.USE_FILES = exports.USE_MRS = exports.USE_LABELS = exports.USE_WORKITEMS = exports.USE_PIPELINE = exports.USE_MILESTONE = exports.USE_GITLAB_WIKI = exports.GITLAB_DENIED_TOOLS_REGEX = exports.GITLAB_READ_ONLY_MODE = exports.IS_OLD = exports.GITLAB_AUTH_COOKIE_PATH = exports.GITLAB_TOKEN = void 0;
+exports.packageVersion = exports.packageName = exports.GITLAB_ALLOWED_PROJECT_IDS = exports.GITLAB_PROJECT_ID = exports.GITLAB_API_URL = exports.GITLAB_BASE_URL = exports.GITLAB_CA_CERT_PATH = exports.NODE_TLS_REJECT_UNAUTHORIZED = exports.HTTPS_PROXY = exports.HTTP_PROXY = exports.SKIP_TLS_VERIFY = exports.RATE_LIMIT_SESSION_MAX_REQUESTS = exports.RATE_LIMIT_SESSION_WINDOW_MS = exports.RATE_LIMIT_SESSION_ENABLED = exports.RATE_LIMIT_IP_MAX_REQUESTS = exports.RATE_LIMIT_IP_WINDOW_MS = exports.RATE_LIMIT_IP_ENABLED = exports.API_TIMEOUT_MS = exports.TRUST_PROXY = exports.SSL_PASSPHRASE = exports.SSL_CA_PATH = exports.SSL_KEY_PATH = exports.SSL_CERT_PATH = exports.PORT = exports.HOST = exports.USE_WEBHOOKS = exports.USE_SNIPPETS = exports.USE_VARIABLES = exports.USE_FILES = exports.USE_MRS = exports.USE_LABELS = exports.USE_WORKITEMS = exports.USE_PIPELINE = exports.USE_MILESTONE = exports.USE_GITLAB_WIKI = exports.GITLAB_DENIED_TOOLS_REGEX = exports.GITLAB_READ_ONLY_MODE = exports.IS_OLD = exports.GITLAB_AUTH_COOKIE_PATH = exports.GITLAB_TOKEN = void 0;
 exports.getEffectiveProjectId = getEffectiveProjectId;
 exports.getToolDescriptionOverrides = getToolDescriptionOverrides;
 const path = __importStar(require("path"));
@@ -54,6 +54,7 @@ exports.USE_LABELS = process.env.USE_LABELS !== "false";
 exports.USE_MRS = process.env.USE_MRS !== "false";
 exports.USE_FILES = process.env.USE_FILES !== "false";
 exports.USE_VARIABLES = process.env.USE_VARIABLES !== "false";
+exports.USE_SNIPPETS = process.env.USE_SNIPPETS !== "false";
 exports.USE_WEBHOOKS = process.env.USE_WEBHOOKS !== "false";
 exports.HOST = process.env.HOST ?? "0.0.0.0";
 exports.PORT = process.env.PORT ?? 3002;

package/dist/src/config.js.map

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

package/dist/src/entities/snippets/index.d.ts

@@ -0,0 +1,7 @@
+export * from "../shared";
+export * from "./schema-readonly";
+export * from "./schema";
+export * from "./registry";
+import type { ToolDefinition } from "../../types";
+export declare const snippetsTools: ToolDefinition[];
+export declare const snippetsReadOnlyTools: string[];

package/dist/src/entities/snippets/index.js

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snippetsReadOnlyTools = exports.snippetsTools = void 0;
+__exportStar(require("../shared"), exports);
+__exportStar(require("./schema-readonly"), exports);
+__exportStar(require("./schema"), exports);
+__exportStar(require("./registry"), exports);
+const registry_1 = require("./registry");
+const isReadOnly = process.env.GITLAB_READONLY === "true";
+const snippetsToolsFromRegistry = (0, registry_1.getFilteredSnippetsTools)(isReadOnly);
+exports.snippetsTools = snippetsToolsFromRegistry.map((tool) => ({
+    name: tool.name,
+    description: tool.description,
+    inputSchema: tool.inputSchema,
+}));
+exports.snippetsReadOnlyTools = (0, registry_1.getSnippetsReadOnlyToolNames)();
+//# sourceMappingURL=index.js.map

package/dist/src/entities/snippets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/entities/snippets/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AACA,4CAA0B;AAG1B,oDAAkC;AAGlC,2CAAyB;AAGzB,6CAA2B;AAG3B,yCAAoF;AAIpF,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM,CAAC;AAG1D,MAAM,yBAAyB,GAAG,IAAA,mCAAwB,EAAC,UAAU,CAAC,CAAC;AAG1D,QAAA,aAAa,GAAqB,yBAAyB,CAAC,GAAG,CAC1E,CAAC,IAAI,EAAkB,EAAE,CAAC,CAAC;IACzB,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;CAC9B,CAAC,CACH,CAAC;AAGW,QAAA,qBAAqB,GAAG,IAAA,uCAA4B,GAAE,CAAC"}

package/dist/src/entities/snippets/registry.d.ts

@@ -0,0 +1,5 @@
+import { ToolRegistry, EnhancedToolDefinition } from "../../types";
+export declare const snippetsToolRegistry: ToolRegistry;
+export declare function getSnippetsReadOnlyToolNames(): string[];
+export declare function getSnippetsToolDefinitions(): EnhancedToolDefinition[];
+export declare function getFilteredSnippetsTools(readOnlyMode?: boolean): EnhancedToolDefinition[];

package/dist/src/entities/snippets/registry.js

@@ -0,0 +1,186 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snippetsToolRegistry = void 0;
+exports.getSnippetsReadOnlyToolNames = getSnippetsReadOnlyToolNames;
+exports.getSnippetsToolDefinitions = getSnippetsToolDefinitions;
+exports.getFilteredSnippetsTools = getFilteredSnippetsTools;
+const z = __importStar(require("zod"));
+const schema_readonly_1 = require("./schema-readonly");
+const schema_1 = require("./schema");
+const gitlab_api_1 = require("../../utils/gitlab-api");
+const ManageSnippetSchema = z.discriminatedUnion("action", [
+    schema_readonly_1.GetSnippetSchema,
+    schema_1.CreateSnippetSchema,
+    schema_1.UpdateSnippetSchema,
+    schema_1.DeleteSnippetSchema,
+]);
+exports.snippetsToolRegistry = new Map([
+    [
+        "list_snippets",
+        {
+            name: "list_snippets",
+            description: "List GitLab code snippets with flexible scoping. Use scope='personal' for current user's snippets, scope='project' for project-specific snippets (requires projectId), or scope='public' to discover all public snippets. Filter by visibility level (private/internal/public) and creation date. Snippets are reusable code blocks, configs, or text that support versioning and can be shared.",
+            inputSchema: z.toJSONSchema(schema_readonly_1.ListSnippetsSchema),
+            handler: async (args) => {
+                const options = schema_readonly_1.ListSnippetsSchema.parse(args);
+                let path;
+                if (options.scope === "personal") {
+                    path = "snippets";
+                }
+                else if (options.scope === "public") {
+                    path = "snippets/public";
+                }
+                else {
+                    if (!options.projectId) {
+                        throw new Error("projectId is required for project scope");
+                    }
+                    const encodedProjectId = encodeURIComponent(options.projectId);
+                    path = `projects/${encodedProjectId}/snippets`;
+                }
+                return gitlab_api_1.gitlab.get(path, {
+                    query: (0, gitlab_api_1.toQuery)(options, ["scope", "projectId"]),
+                });
+            },
+        },
+    ],
+    [
+        "manage_snippet",
+        {
+            name: "manage_snippet",
+            description: "Manage GitLab snippets with full CRUD operations via action parameter. action='read': retrieve snippet metadata or raw content. action='create': create new snippet with multiple files, visibility control. action='update': modify title, description, visibility, or files (supports create/update/delete/move file actions). action='delete': permanently remove snippet. Supports both personal and project snippets. Multi-file snippets enable organizing related code in one place.",
+            inputSchema: z.toJSONSchema(ManageSnippetSchema),
+            handler: async (args) => {
+                const options = ManageSnippetSchema.parse(args);
+                switch (options.action) {
+                    case "read": {
+                        const encodedId = options.id.toString();
+                        let path;
+                        if (options.projectId) {
+                            const encodedProjectId = encodeURIComponent(options.projectId);
+                            path = `projects/${encodedProjectId}/snippets/${encodedId}`;
+                        }
+                        else {
+                            path = `snippets/${encodedId}`;
+                        }
+                        if (options.raw) {
+                            path = `${path}/raw`;
+                        }
+                        return gitlab_api_1.gitlab.get(path);
+                    }
+                    case "create": {
+                        const body = {
+                            title: options.title,
+                            visibility: options.visibility,
+                            files: options.files,
+                        };
+                        if (options.description) {
+                            body.description = options.description;
+                        }
+                        let path;
+                        if (options.projectId) {
+                            const encodedProjectId = encodeURIComponent(options.projectId);
+                            path = `projects/${encodedProjectId}/snippets`;
+                        }
+                        else {
+                            path = "snippets";
+                        }
+                        return gitlab_api_1.gitlab.post(path, {
+                            body,
+                            contentType: "json",
+                        });
+                    }
+                    case "update": {
+                        const encodedId = options.id.toString();
+                        const body = {};
+                        if (options.title !== undefined) {
+                            body.title = options.title;
+                        }
+                        if (options.description !== undefined) {
+                            body.description = options.description;
+                        }
+                        if (options.visibility !== undefined) {
+                            body.visibility = options.visibility;
+                        }
+                        if (options.files !== undefined) {
+                            body.files = options.files;
+                        }
+                        let path;
+                        if (options.projectId) {
+                            const encodedProjectId = encodeURIComponent(options.projectId);
+                            path = `projects/${encodedProjectId}/snippets/${encodedId}`;
+                        }
+                        else {
+                            path = `snippets/${encodedId}`;
+                        }
+                        return gitlab_api_1.gitlab.put(path, {
+                            body,
+                            contentType: "json",
+                        });
+                    }
+                    case "delete": {
+                        const encodedId = options.id.toString();
+                        let path;
+                        if (options.projectId) {
+                            const encodedProjectId = encodeURIComponent(options.projectId);
+                            path = `projects/${encodedProjectId}/snippets/${encodedId}`;
+                        }
+                        else {
+                            path = `snippets/${encodedId}`;
+                        }
+                        await gitlab_api_1.gitlab.delete(path);
+                        return { deleted: true, id: options.id };
+                    }
+                    default:
+                        throw new Error(`Unknown action: ${options.action}`);
+                }
+            },
+        },
+    ],
+]);
+function getSnippetsReadOnlyToolNames() {
+    return ["list_snippets"];
+}
+function getSnippetsToolDefinitions() {
+    return Array.from(exports.snippetsToolRegistry.values());
+}
+function getFilteredSnippetsTools(readOnlyMode = false) {
+    if (readOnlyMode) {
+        const readOnlyNames = getSnippetsReadOnlyToolNames();
+        return Array.from(exports.snippetsToolRegistry.values()).filter(tool => readOnlyNames.includes(tool.name));
+    }
+    return getSnippetsToolDefinitions();
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/entities/snippets/registry.js.map

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

package/dist/src/entities/snippets/schema-readonly.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export declare const ListSnippetsSchema: z.ZodObject<{
+    scope: z.ZodEnum<{
+        project: "project";
+        public: "public";
+        personal: "personal";
+    }>;
+    projectId: z.ZodOptional<z.ZodString>;
+    visibility: z.ZodOptional<z.ZodEnum<{
+        private: "private";
+        internal: "internal";
+        public: "public";
+    }>>;
+    created_after: z.ZodOptional<z.ZodString>;
+    created_before: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    per_page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export declare const GetSnippetSchema: z.ZodObject<{
+    action: z.ZodLiteral<"read">;
+    id: z.ZodNumber;
+    projectId: z.ZodOptional<z.ZodString>;
+    raw: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type ListSnippetsOptions = z.infer<typeof ListSnippetsSchema>;
+export type GetSnippetOptions = z.infer<typeof GetSnippetSchema>;

package/dist/src/entities/snippets/schema-readonly.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetSnippetSchema = exports.ListSnippetsSchema = void 0;
+const zod_1 = require("zod");
+const shared_1 = require("../shared");
+const SnippetScopeSchema = zod_1.z.enum(["personal", "project", "public"]);
+exports.ListSnippetsSchema = zod_1.z
+    .object({
+    scope: SnippetScopeSchema.describe('The scope of snippets to list: "personal" for current user snippets, "project" for project-specific snippets, "public" for all public snippets'),
+    projectId: zod_1.z
+        .string()
+        .optional()
+        .describe("Project ID or URL-encoded path (required when scope is 'project'). Example: '123' or 'group/project'"),
+    visibility: zod_1.z
+        .enum(["private", "internal", "public"])
+        .optional()
+        .describe("Filter snippets by visibility level. Private: only author can see. Internal: authenticated users can see. Public: anyone can see"),
+    created_after: zod_1.z
+        .string()
+        .optional()
+        .describe("Return snippets created after this date (ISO 8601 format). Example: '2024-01-01T00:00:00Z'"),
+    created_before: zod_1.z
+        .string()
+        .optional()
+        .describe("Return snippets created before this date (ISO 8601 format). Example: '2024-12-31T23:59:59Z'"),
+})
+    .merge(shared_1.PaginationOptionsSchema)
+    .refine(data => data.scope !== "project" || data.projectId, {
+    message: "projectId is required when scope is 'project'",
+    path: ["projectId"],
+});
+const GetSnippetActionSchema = zod_1.z.literal("read");
+exports.GetSnippetSchema = zod_1.z
+    .object({
+    action: GetSnippetActionSchema.describe("Must be 'read' for retrieving snippet details"),
+    id: zod_1.z.number().int().positive().describe("The ID of the snippet to retrieve"),
+    projectId: zod_1.z
+        .string()
+        .optional()
+        .describe("Project ID or URL-encoded path (required for project snippets). Leave empty for personal snippets"),
+    raw: zod_1.z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Return raw content of the snippet files instead of metadata. Useful for downloading snippet content directly"),
+})
+    .refine(data => !data.projectId || typeof data.projectId === "string", {
+    message: "projectId must be a string when provided",
+    path: ["projectId"],
+});
+//# sourceMappingURL=schema-readonly.js.map

package/dist/src/entities/snippets/schema-readonly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-readonly.js","sourceRoot":"","sources":["../../../../src/entities/snippets/schema-readonly.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,sCAAoD;AAKpD,MAAM,kBAAkB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGxD,QAAA,kBAAkB,GAAG,OAAC;KAChC,MAAM,CAAC;IACN,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAChC,gJAAgJ,CACjJ;IACD,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sGAAsG,CACvG;IACH,UAAU,EAAE,OAAC;SACV,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;SACvC,QAAQ,EAAE;SACV,QAAQ,CACP,kIAAkI,CACnI;IACH,aAAa,EAAE,OAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4FAA4F,CAC7F;IACH,cAAc,EAAE,OAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,6FAA6F,CAC9F;CACJ,CAAC;KACD,KAAK,CAAC,gCAAuB,CAAC;KAC9B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE;IAC1D,OAAO,EAAE,+CAA+C;IACxD,IAAI,EAAE,CAAC,WAAW,CAAC;CACpB,CAAC,CAAC;AAGL,MAAM,sBAAsB,GAAG,OAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAGpC,QAAA,gBAAgB,GAAG,OAAC;KAC9B,MAAM,CAAC;IACN,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IACxF,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC7E,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mGAAmG,CACpG;IACH,GAAG,EAAE,OAAC;SACH,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,8GAA8G,CAC/G;CACJ,CAAC;KACD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE;IACrE,OAAO,EAAE,0CAA0C;IACnD,IAAI,EAAE,CAAC,WAAW,CAAC;CACpB,CAAC,CAAC"}

package/dist/src/entities/snippets/schema.d.ts

@@ -0,0 +1,60 @@
+import { z } from "zod";
+declare const SnippetFileSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    action: z.ZodOptional<z.ZodEnum<{
+        create: "create";
+        update: "update";
+        delete: "delete";
+        move: "move";
+    }>>;
+    previous_path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CreateSnippetSchema: z.ZodObject<{
+    action: z.ZodLiteral<"create">;
+    projectId: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    visibility: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodEnum<{
+        private: "private";
+        internal: "internal";
+        public: "public";
+    }>>>>;
+    files: z.ZodArray<z.ZodObject<{
+        file_path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const UpdateSnippetSchema: z.ZodObject<{
+    action: z.ZodLiteral<"update">;
+    id: z.ZodNumber;
+    projectId: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    visibility: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodEnum<{
+        private: "private";
+        internal: "internal";
+        public: "public";
+    }>>>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        file_path: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        action: z.ZodOptional<z.ZodEnum<{
+            create: "create";
+            update: "update";
+            delete: "delete";
+            move: "move";
+        }>>;
+        previous_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const DeleteSnippetSchema: z.ZodObject<{
+    action: z.ZodLiteral<"delete">;
+    id: z.ZodNumber;
+    projectId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateSnippetOptions = z.infer<typeof CreateSnippetSchema>;
+export type UpdateSnippetOptions = z.infer<typeof UpdateSnippetSchema>;
+export type DeleteSnippetOptions = z.infer<typeof DeleteSnippetSchema>;
+export type SnippetFile = z.infer<typeof SnippetFileSchema>;
+export {};