@varmdev/api-kit 0.1.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VARM
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# @varmdev/api-kit
+
+`api-kit` — это универсальный набор для создания типизированных API на TypeScript. Он помогает описывать контракт эндпоинта, валидировать входные данные, держать единый формат ответов, собирать OpenAPI-спецификацию и подключать это к SvelteKit.
+
+Пакет не знает ничего о вашей базе данных, бизнес-логике и конкретной авторизации. Он даёт инфраструктурный слой, а приложение решает, как именно получать пользователя, как проверять права и что делать внутри хендлера.
+
+## Что Умеет Пакет
+
+- описывать endpoint как контракт через `defineEndpoint`;
+- валидировать `params`, `query`, `body` и `response` через Zod;
+- стандартизировать успешные и ошибочные JSON-ответы;
+- поднимать `ApiKitError` для ожидаемых HTTP-ошибок;
+- накапливать OpenAPI-метаданные и генерировать спецификацию;
+- давать `typedFetch` для клиентского кода;
+- давать `generateQuerySchema` для query-параметров;
+- адаптировать всё это под SvelteKit через `apiHandler`.
+
+## Когда Он Полезен
+
+- когда в проекте много endpoint-ов и хочется держать их в одном стиле;
+- когда хочется, чтобы типы, валидация и OpenAPI жили из одного описания;
+- когда нужно переиспользовать один и тот же подход в нескольких проектах;
+- когда SvelteKit нужен только как транспорт, а не как место для всей логики API.
+
+## Структура
+
+```text
+src/core/
+  endpoint.ts      # defineEndpoint и типы endpoint-контракта
+  apiRegistry.ts   # OpenAPI registry и генерация документа
+  client.ts        # typedFetch и вывод типов endpoint-а
+  query.ts         # generateQuerySchema для URL query
+  errors.ts        # ApiKitError и преобразование Zod issues
+  responses.ts     # success/error response schemas
+  cache.ts         # cache policy -> HTTP headers
+
+src/sveltekit/
+  apiHandler.ts    # адаптер EndpointDefinition -> SvelteKit RequestHandler
+```
+
+`src/core` не зависит от SvelteKit. Вся SvelteKit-специфика остаётся в `src/sveltekit`.
+
+## Точки Входа
+
+```ts
+import { defineEndpoint } from '@varmdev/api-kit/core';
+import { createOpenApiRegistry } from '@varmdev/api-kit/apiRegistry';
+import { apiHandler } from '@varmdev/api-kit/apiHandler';
+import { typedFetch } from '@varmdev/api-kit/client';
+import { generateQuerySchema } from '@varmdev/api-kit/query';
+```
+
+Если нужен явный путь для SvelteKit-адаптера:
+
+```ts
+import { apiHandler } from '@varmdev/api-kit/sveltekit/apiHandler';
+```
+
+## Как Это Выглядит
+
+```ts
+import { z } from 'zod';
+import { defineEndpoint } from '@varmdev/api-kit/core';
+import { apiHandler } from '@varmdev/api-kit/sveltekit/apiHandler';
+
+const endpoint = defineEndpoint({
+  querySchema: z.object({
+    q: z.string().optional()
+  }),
+  responseSchema: z.object({
+    items: z.array(z.string())
+  }),
+  openapi: {
+    method: 'GET',
+    path: '/api/examples',
+    summary: 'Example endpoint',
+    tags: ['Examples']
+  },
+  handler: async ({ query }) => ({
+    items: query.q ? [query.q] : []
+  })
+});
+
+export const GET = apiHandler(endpoint);
+```
+
+## Установка
+
+Локально в соседнем репозитории:
+
+```bash
+bun add @varmdev/api-kit@file:../api-kit
+```
+
+Из npm:
+
+```json
+{
+  "dependencies": {
+    "@varmdev/api-kit": "^0.1.7"
+  }
+}
+```
+
+Или через `npm`:
+
+```bash
+npm install @varmdev/api-kit
+```
+
+## Статус
+
+Пакет в ранней версии. API может немного меняться до 1.0.
+
+## Разработка
+
+```bash
+bun install
+bun run check
+bun run build
+```

package/dist/core/apiRegistry.d.ts

@@ -0,0 +1,46 @@
+import { OpenAPIRegistry } from '@asteasolutions/zod-to-openapi';
+import { type ZodType } from 'zod';
+import type { EndpointDefinition, EndpointOpenApi, HttpMethod } from './endpoint.js';
+export type { EndpointOpenApi, HttpMethod };
+export type ApiKitOpenApiRegistry = {
+    registry: OpenAPIRegistry;
+    registerEndpoint: (endpoint: EndpointDefinition<ZodType | null, ZodType | null, ZodType | null>) => void;
+    generateDocument: (options?: {
+        title?: string;
+        version?: string;
+    }) => unknown;
+};
+/**
+ * Создает изолированный OpenAPI-реестр.
+ *
+ * Обычно приложение создает один реестр и импортирует все модули эндпоинтов
+ * перед генерацией документа. Так каждый эндпоинт успевает зарегистрировать
+ * себя. Именно так сейчас работает endpoint документации API в VARM.
+ */
+export declare const createOpenApiRegistry: () => ApiKitOpenApiRegistry;
+export declare const defaultOpenApi: ApiKitOpenApiRegistry;
+export declare const openApiRegistry: OpenAPIRegistry;
+export declare const bearerAuthScheme: {
+    name: string;
+    ref: {
+        $ref: string;
+    };
+};
+export declare const apiKeyAuthScheme: {
+    name: string;
+    ref: {
+        $ref: string;
+    };
+};
+export declare const refreshTokenCookieScheme: {
+    name: string;
+    ref: {
+        $ref: string;
+    };
+};
+export declare const registerEndpoint: (endpoint: EndpointDefinition<ZodType | null, ZodType | null, ZodType | null>) => void;
+export declare const generateOpenApiSpec: (options?: {
+    title?: string;
+    version?: string;
+}) => unknown;
+//# sourceMappingURL=apiRegistry.d.ts.map

package/dist/core/apiRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiRegistry.d.ts","sourceRoot":"","sources":["../../src/core/apiRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EAGf,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAK,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIrF,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC;AAE5C,MAAM,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,eAAe,CAAC;IAC1B,gBAAgB,EAAE,CAAC,QAAQ,EAAE,kBAAkB,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC;IACzG,gBAAgB,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;CAC9E,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,QAAO,qBA+FxC,CAAC;AAEF,eAAO,MAAM,cAAc,uBAA0B,CAAC;AAEtD,eAAO,MAAM,eAAe,iBAA0B,CAAC;AAEvD,eAAO,MAAM,gBAAgB;;;;;CAQ5B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;CAI3B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;CAQpC,CAAC;AAEF,eAAO,MAAM,gBAAgB,aA1IC,kBAAkB,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC,KAAK,IA0ItC,CAAC;AAChE,eAAO,MAAM,mBAAmB,aA1IF;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OA0IL,CAAC"}

package/dist/core/apiRegistry.js

@@ -0,0 +1,122 @@
+import { OpenAPIRegistry, OpenApiGeneratorV31, extendZodWithOpenApi } from '@asteasolutions/zod-to-openapi';
+import { z } from 'zod';
+import { ApiErrorResponseSchema } from './responses.js';
+extendZodWithOpenApi(z);
+/**
+ * Создает изолированный OpenAPI-реестр.
+ *
+ * Обычно приложение создает один реестр и импортирует все модули эндпоинтов
+ * перед генерацией документа. Так каждый эндпоинт успевает зарегистрировать
+ * себя. Именно так сейчас работает endpoint документации API в VARM.
+ */
+export const createOpenApiRegistry = () => {
+    const registry = new OpenAPIRegistry();
+    return {
+        registry,
+        registerEndpoint(endpoint) {
+            const { method, path, summary, description, tags, security } = endpoint.openapi;
+            const roles = Array.from(endpoint.roles ?? []);
+            const responseStatus = method === 'POST' ? 201 : method === 'DELETE' ? 204 : 200;
+            const pathDefinition = {
+                method: method.toLowerCase(),
+                path,
+                summary,
+                description: roles.length
+                    ? `${description ?? ''}\n\nRequired roles: ${roles.join(', ')}`.trim()
+                    : description,
+                tags,
+                security,
+                responses: {
+                    400: {
+                        description: 'Bad request / validation error',
+                        content: {
+                            'application/json': {
+                                schema: ApiErrorResponseSchema
+                            }
+                        }
+                    },
+                    500: {
+                        description: 'Server error',
+                        content: {
+                            'application/json': {
+                                schema: ApiErrorResponseSchema
+                            }
+                        }
+                    }
+                }
+            };
+            if (!pathDefinition.security && (endpoint.requireAuth || roles.length)) {
+                pathDefinition.security = [{ BearerAuth: [], ApiKeyAuth: [], RefreshTokenCookie: [] }];
+            }
+            if (endpoint.paramsSchema) {
+                pathDefinition.request = {
+                    ...pathDefinition.request,
+                    params: endpoint.paramsSchema
+                };
+            }
+            if (endpoint.querySchema) {
+                pathDefinition.request = {
+                    ...pathDefinition.request,
+                    query: endpoint.querySchema
+                };
+            }
+            const requestBodySchema = endpoint.docsBodySchema ?? endpoint.bodySchema;
+            if (requestBodySchema) {
+                pathDefinition.request = {
+                    ...pathDefinition.request,
+                    body: {
+                        content: {
+                            [endpoint.docsBodyContentType ?? 'application/json']: {
+                                schema: requestBodySchema
+                            }
+                        }
+                    }
+                };
+            }
+            if (endpoint.responseSchema && responseStatus !== 204) {
+                pathDefinition.responses[responseStatus] = {
+                    description: 'Successful response',
+                    content: {
+                        'application/json': {
+                            schema: endpoint.responseSchema
+                        }
+                    }
+                };
+            }
+            else {
+                pathDefinition.responses[responseStatus] = { description: 'Successful response' };
+            }
+            registry.registerPath(pathDefinition);
+        },
+        generateDocument(options = {}) {
+            const generator = new OpenApiGeneratorV31(registry.definitions);
+            return generator.generateDocument({
+                openapi: '3.1.0',
+                info: {
+                    title: options.title ?? 'API',
+                    version: options.version ?? '1.0.0'
+                }
+            });
+        }
+    };
+};
+export const defaultOpenApi = createOpenApiRegistry();
+export const openApiRegistry = defaultOpenApi.registry;
+export const bearerAuthScheme = openApiRegistry.registerComponent('securitySchemes', 'BearerAuth', {
+    type: 'http',
+    scheme: 'bearer',
+    bearerFormat: 'JWT'
+});
+export const apiKeyAuthScheme = openApiRegistry.registerComponent('securitySchemes', 'ApiKeyAuth', {
+    type: 'apiKey',
+    in: 'header',
+    name: 'X-API-Key'
+});
+export const refreshTokenCookieScheme = openApiRegistry.registerComponent('securitySchemes', 'RefreshTokenCookie', {
+    type: 'apiKey',
+    in: 'cookie',
+    name: 'refresh_token'
+});
+export const registerEndpoint = defaultOpenApi.registerEndpoint;
+export const generateOpenApiSpec = defaultOpenApi.generateDocument;
+//# sourceMappingURL=apiRegistry.js.map

package/dist/core/apiRegistry.js.map

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

package/dist/core/cache.d.ts

@@ -0,0 +1,14 @@
+export type ApiCachePolicy = 'no-store' | {
+    scope?: 'private' | 'public';
+    maxAge: number;
+    staleWhileRevalidate?: number;
+    mustRevalidate?: boolean;
+};
+/**
+ * Преобразует декларативную политику кеширования в HTTP-заголовки.
+ *
+ * Функция остается независимой от фреймворка: адаптеры могут перенести эти
+ * заголовки в SvelteKit, Hono, Bun.serve или любую другую реализацию Web Response.
+ */
+export declare const toCacheHeaders: (policy: ApiCachePolicy) => Record<string, string>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/core/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACvB,UAAU,GACV;IACA,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,cAAc,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAoB5E,CAAC"}

package/dist/core/cache.js

@@ -0,0 +1,26 @@
+/**
+ * Преобразует декларативную политику кеширования в HTTP-заголовки.
+ *
+ * Функция остается независимой от фреймворка: адаптеры могут перенести эти
+ * заголовки в SvelteKit, Hono, Bun.serve или любую другую реализацию Web Response.
+ */
+export const toCacheHeaders = (policy) => {
+    if (policy === 'no-store') {
+        return {
+            'Cache-Control': 'no-store, no-cache, must-revalidate',
+            Pragma: 'no-cache',
+            Expires: '0'
+        };
+    }
+    const directives = [
+        policy.scope ?? 'private',
+        `max-age=${Math.max(0, Math.floor(policy.maxAge))}`
+    ];
+    if (policy.mustRevalidate)
+        directives.push('must-revalidate');
+    if (policy.staleWhileRevalidate != null) {
+        directives.push(`stale-while-revalidate=${Math.max(0, Math.floor(policy.staleWhileRevalidate))}`);
+    }
+    return { 'Cache-Control': directives.join(', ') };
+};
+//# sourceMappingURL=cache.js.map

package/dist/core/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAsB,EAA0B,EAAE;IAChF,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC3B,OAAO;YACN,eAAe,EAAE,qCAAqC;YACtD,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,GAAG;SACZ,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG;QAClB,MAAM,CAAC,KAAK,IAAI,SAAS;QACzB,WAAW,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE;KACnD,CAAC;IACF,IAAI,MAAM,CAAC,cAAc;QAAE,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9D,IAAI,MAAM,CAAC,oBAAoB,IAAI,IAAI,EAAE,CAAC;QACzC,UAAU,CAAC,IAAI,CACd,0BAA0B,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAChF,CAAC;IACH,CAAC;IACD,OAAO,EAAE,eAAe,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACnD,CAAC,CAAC"}

package/dist/core/client.d.ts

@@ -0,0 +1,29 @@
+import { type z, type ZodType } from 'zod';
+import type { EndpointDefinition } from './endpoint.js';
+export type InferEndpointTypes<T extends EndpointDefinition<ZodType | null, ZodType | null, ZodType | null>> = {
+    params: T['paramsSchema'] extends ZodType ? z.input<T['paramsSchema']> : never;
+    query: T['querySchema'] extends ZodType ? z.input<T['querySchema']> : never;
+    body: T['bodySchema'] extends ZodType ? z.input<T['bodySchema']> : never;
+    parsed: {
+        params: T['paramsSchema'] extends ZodType ? z.output<T['paramsSchema']> : never;
+        query: T['querySchema'] extends ZodType ? z.output<T['querySchema']> : never;
+        body: T['bodySchema'] extends ZodType ? z.output<T['bodySchema']> : never;
+    };
+    response: Awaited<ReturnType<T['handler']>>;
+};
+type TypedFetchOptions<T extends EndpointDefinition<ZodType | null, ZodType | null, ZodType | null>> = {
+    params?: InferEndpointTypes<T>['params'];
+    query?: InferEndpointTypes<T>['query'];
+    body?: InferEndpointTypes<T>['body'];
+    init?: RequestInit;
+    baseUrl?: string;
+};
+/**
+ * Небольшой типизированный fetch-помощник для клиентов, импортирующих описания эндпоинтов.
+ *
+ * Он намеренно почти ничего не предполагает о транспорте: приложение само
+ * передает `baseUrl`, credentials, headers и остальные настройки RequestInit.
+ */
+export declare function typedFetch<T extends EndpointDefinition<ZodType | null, ZodType | null, ZodType | null>>(endpoint: T, options?: TypedFetchOptions<T>): Promise<InferEndpointTypes<T>['response']>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,kBAAkB,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC,IAAI;IAC9G,MAAM,EAAE,CAAC,CAAC,cAAc,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,GAAG,KAAK,CAAC;IAC/E,KAAK,EAAE,CAAC,CAAC,aAAa,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,GAAG,KAAK,CAAC;IAC5E,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,GAAG,KAAK,CAAC;IACzE,MAAM,EAAE;QACP,MAAM,EAAE,CAAC,CAAC,cAAc,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,GAAG,KAAK,CAAC;QAChF,KAAK,EAAE,CAAC,CAAC,aAAa,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,GAAG,KAAK,CAAC;QAC7E,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,GAAG,KAAK,CAAC;KAC1E,CAAC;IACF,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;CAC5C,CAAC;AAEF,KAAK,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC,IAAI;IACtG,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AA2BF;;;;;GAKG;AACH,wBAAsB,UAAU,CAC/B,CAAC,SAAS,kBAAkB,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC,EAC3E,QAAQ,EAAE,CAAC,EAAE,OAAO,GAAE,iBAAiB,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAoB7F"}

package/dist/core/client.js

@@ -0,0 +1,56 @@
+import {} from 'zod';
+const fillPathParams = (path, params) => {
+    if (!params || typeof params !== 'object')
+        return path;
+    let next = path;
+    for (const [key, value] of Object.entries(params)) {
+        next = next.replace(`:${key}`, encodeURIComponent(String(value)));
+        next = next.replace(`[${key}]`, encodeURIComponent(String(value)));
+    }
+    return next;
+};
+const appendQuery = (path, query) => {
+    if (!query || typeof query !== 'object')
+        return path;
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value == null)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                search.append(key, String(item));
+        }
+        else {
+            search.set(key, String(value));
+        }
+    }
+    const qs = search.toString();
+    return qs ? `${path}${path.includes('?') ? '&' : '?'}${qs}` : path;
+};
+/**
+ * Небольшой типизированный fetch-помощник для клиентов, импортирующих описания эндпоинтов.
+ *
+ * Он намеренно почти ничего не предполагает о транспорте: приложение само
+ * передает `baseUrl`, credentials, headers и остальные настройки RequestInit.
+ */
+export async function typedFetch(endpoint, options = {}) {
+    const method = endpoint.openapi.method;
+    const pathWithParams = fillPathParams(endpoint.openapi.path, options.params);
+    const pathWithQuery = appendQuery(pathWithParams, options.query);
+    const url = `${options.baseUrl ?? ''}${pathWithQuery}`;
+    const headers = new Headers(options.init?.headers);
+    if (options.body !== undefined && !headers.has('content-type')) {
+        headers.set('content-type', 'application/json');
+    }
+    const response = await fetch(url, {
+        ...options.init,
+        method,
+        headers,
+        body: options.body !== undefined ? JSON.stringify(options.body) : options.init?.body
+    });
+    if (!response.ok)
+        throw new Error(`Request failed with ${response.status}`);
+    const payload = await response.json();
+    return (payload?.data ?? payload);
+}
+//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

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

package/dist/core/endpoint.d.ts

@@ -0,0 +1,54 @@
+import { type z, type ZodType } from 'zod';
+import type { ApiCachePolicy } from './cache.js';
+export type HttpMethod = 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
+export type EndpointOpenApi = {
+    method: HttpMethod;
+    path: string;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    security?: Record<string, string[]>[];
+};
+export type EndpointHandlerContext<Params, Query, Body, User = unknown, AdapterContext = unknown> = {
+    params: Params;
+    query: Query;
+    body: Body;
+    request: Request;
+    user?: User;
+    /**
+     * Контекст конкретного фреймворка.
+     *
+     * Для SvelteKit здесь лежит RequestEvent. Адаптеры Hono/Fastify/etc. могут
+     * передавать сюда свой контекст, не протаскивая эти типы в ядро пакета.
+     */
+    adapter: AdapterContext;
+};
+export type EndpointDefinition<ParamsSchema extends ZodType | null = null, QuerySchema extends ZodType | null = null, BodySchema extends ZodType | null = null, Response = unknown, ResponseSchema extends ZodType | null = null, Role extends string = string, User = unknown, AdapterContext = unknown> = {
+    paramsSchema?: ParamsSchema | null;
+    querySchema?: QuerySchema | null;
+    bodySchema?: BodySchema | null;
+    /**
+     * Схема и content-type тела запроса только для документации.
+     *
+     * Используется, когда тело запроса обрабатывается в эндпоинте вручную
+     * (например, multipart/form-data), но OpenAPI все равно должен описать
+     * формат входных данных.
+     */
+    docsBodySchema?: ZodType | null;
+    docsBodyContentType?: string;
+    responseSchema?: ResponseSchema | null;
+    requireAuth?: boolean;
+    roles?: readonly Role[];
+    cachePolicy?: ApiCachePolicy;
+    openapi: EndpointOpenApi;
+    handler: (ctx: EndpointHandlerContext<ParamsSchema extends ZodType ? z.output<ParamsSchema> : Record<string, string>, QuerySchema extends ZodType ? z.output<QuerySchema> : Record<string, string>, BodySchema extends ZodType ? z.output<BodySchema> : unknown, User, AdapterContext>) => Response | Promise<Response>;
+};
+/**
+ * Помощник без runtime-логики, сохраняющий вывод generic-типов эндпоинта.
+ *
+ * Если описывать эндпоинты через эту функцию, вызывающий код получает строгие
+ * типы для входа хендлера, typedFetch и проверки ответа без дополнительных
+ * действий во время выполнения.
+ */
+export declare const defineEndpoint: <ParamsSchema extends ZodType | null = null, QuerySchema extends ZodType | null = null, BodySchema extends ZodType | null = null, Response = unknown, ResponseSchema extends ZodType | null = null, Role extends string = string, User = unknown, AdapterContext = unknown>(definition: EndpointDefinition<ParamsSchema, QuerySchema, BodySchema, Response, ResponseSchema, Role, User, AdapterContext>) => EndpointDefinition<ParamsSchema, QuerySchema, BodySchema, Response, ResponseSchema, Role, User, AdapterContext>;
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/core/endpoint.d.ts.map

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

package/dist/core/endpoint.js

@@ -0,0 +1,10 @@
+import {} from 'zod';
+/**
+ * Помощник без runtime-логики, сохраняющий вывод generic-типов эндпоинта.
+ *
+ * Если описывать эндпоинты через эту функцию, вызывающий код получает строгие
+ * типы для входа хендлера, typedFetch и проверки ответа без дополнительных
+ * действий во время выполнения.
+ */
+export const defineEndpoint = (definition) => definition;
+//# sourceMappingURL=endpoint.js.map

package/dist/core/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../src/core/endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,KAAK,CAAC;AA0E3C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAU7B,UASC,EACA,EAAE,CAAC,UAAU,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export type ApiIssue = {
+    path: string;
+    message: string;
+};
+/**
+ * Ожидаемая ошибка приложения или API.
+ *
+ * Бросайте ее из хендлеров, когда клиент должен получить конкретный HTTP-статус.
+ * Неизвестные ошибки адаптеры по-прежнему превращают в 500.
+ */
+export declare class ApiKitError extends Error {
+    readonly status: number;
+    readonly issues?: ApiIssue[];
+    readonly expose: boolean;
+    constructor(status: number, message: string, options?: {
+        issues?: ApiIssue[];
+        expose?: boolean;
+    });
+}
+export declare const toApiIssues: (error: z.ZodError) => ApiIssue[];
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEb,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO;CAOpG;AAED,eAAO,MAAM,WAAW,GAAI,OAAO,CAAC,CAAC,QAAQ,KAAG,QAAQ,EAIpD,CAAC"}

package/dist/core/errors.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+/**
+ * Ожидаемая ошибка приложения или API.
+ *
+ * Бросайте ее из хендлеров, когда клиент должен получить конкретный HTTP-статус.
+ * Неизвестные ошибки адаптеры по-прежнему превращают в 500.
+ */
+export class ApiKitError extends Error {
+    status;
+    issues;
+    expose;
+    constructor(status, message, options = {}) {
+        super(message);
+        this.name = 'ApiKitError';
+        this.status = status;
+        this.issues = options.issues;
+        this.expose = options.expose ?? status < 500;
+    }
+}
+export const toApiIssues = (error) => error.issues.map((issue) => ({
+    path: issue.path.join('.'),
+    message: issue.message
+}));
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC5B,MAAM,CAAS;IACf,MAAM,CAAc;IACpB,MAAM,CAAU;IAEzB,YAAY,MAAc,EAAE,OAAe,EAAE,UAAqD,EAAE;QACnG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,GAAG,GAAG,CAAC;IAC9C,CAAC;CACD;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAiB,EAAc,EAAE,CAC5D,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC5B,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;CACtB,CAAC,CAAC,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,8 @@
+export * from './apiRegistry.js';
+export * from './cache.js';
+export * from './client.js';
+export * from './endpoint.js';
+export * from './errors.js';
+export * from './query.js';
+export * from './responses.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,8 @@
+export * from './apiRegistry.js';
+export * from './cache.js';
+export * from './client.js';
+export * from './endpoint.js';
+export * from './errors.js';
+export * from './query.js';
+export * from './responses.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/core/query.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+type Primitive = string | number | boolean | string[];
+type QueryParamDef<T extends Primitive = Primitive> = T | {
+    default: T;
+    description?: string;
+    enum?: T extends string ? readonly [string, ...string[]] : never;
+};
+type QueryParamShape = Record<string, QueryParamDef>;
+/**
+ * Генерирует Zod-схему для query-параметров по значениям по умолчанию.
+ *
+ * Query-параметры приходят строками, поэтому числовые, булевые и массивные
+ * значения по умолчанию также задают правила преобразования входящих строк
+ * для хендлеров эндпоинтов.
+ */
+export declare function generateQuerySchema<T extends QueryParamShape>(params: T): z.ZodObject<{
+    [x: string]: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}, z.core.$strip>;
+export {};
+//# sourceMappingURL=query.d.ts.map

package/dist/core/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/core/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAgB,MAAM,KAAK,CAAC;AAEtC,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;AAEtD,KAAK,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IAC/C,CAAC,GACD;IACA,OAAO,EAAE,CAAC,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC;CAChE,CAAC;AAEL,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,eAAe,EAAE,MAAM,EAAE,CAAC;;kBA6CvE"}

package/dist/core/query.js

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+/**
+ * Генерирует Zod-схему для query-параметров по значениям по умолчанию.
+ *
+ * Query-параметры приходят строками, поэтому числовые, булевые и массивные
+ * значения по умолчанию также задают правила преобразования входящих строк
+ * для хендлеров эндпоинтов.
+ */
+export function generateQuerySchema(params) {
+    const schemaShape = {};
+    for (const [key, def] of Object.entries(params)) {
+        const isObject = typeof def === 'object' && def !== null && 'default' in def;
+        const objectDef = isObject ? def : null;
+        const defaultValue = objectDef?.default ?? def;
+        const description = objectDef?.description ?? `Query param "${key}" (default: ${String(defaultValue)})`;
+        if (objectDef?.enum && typeof defaultValue === 'string') {
+            const enumValues = objectDef.enum;
+            schemaShape[key] = z.enum(enumValues).optional().default(defaultValue).describe(description);
+            continue;
+        }
+        if (typeof defaultValue === 'string') {
+            schemaShape[key] = z.string().optional().default(defaultValue).describe(description);
+        }
+        else if (typeof defaultValue === 'number') {
+            schemaShape[key] = z
+                .string()
+                .transform((value) => (value !== undefined && value !== '' ? Number(value) : defaultValue))
+                .optional()
+                .default(defaultValue)
+                .describe(description);
+        }
+        else if (typeof defaultValue === 'boolean') {
+            schemaShape[key] = z
+                .string()
+                .transform((value) => (value === 'true' ? true : value === 'false' ? false : defaultValue))
+                .optional()
+                .default(defaultValue)
+                .describe(description);
+        }
+        else if (Array.isArray(defaultValue)) {
+            schemaShape[key] = z
+                .string()
+                .transform((value) => (value ? value.split(',') : defaultValue))
+                .optional()
+                .default(defaultValue.map(String))
+                .describe(description);
+        }
+        else {
+            throw new Error(`Unsupported type for query param "${key}"`);
+        }
+    }
+    return z.object(schemaShape);
+}
+//# sourceMappingURL=query.js.map

package/dist/core/query.js.map

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

package/dist/core/responses.d.ts

@@ -0,0 +1,20 @@
+import { z, type ZodType } from 'zod';
+export declare const ApiErrorResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<false>;
+    error: z.ZodString;
+    code: z.ZodNumber;
+    issues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const ApiSuccessResponseSchema: <T extends ZodType>(data: T) => z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    data: T;
+}, z.core.$strip>;
+export type ApiErrorResponse = z.infer<typeof ApiErrorResponseSchema>;
+export type ApiSuccessResponse<T> = {
+    success: true;
+    data: T;
+};
+//# sourceMappingURL=responses.d.ts.map

package/dist/core/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/core/responses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEtC,eAAO,MAAM,sBAAsB;;;;;;;;iBAKjC,CAAC;AAEH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,OAAO,EAAE,MAAM,CAAC;;;iBAIhE,CAAC;AAEJ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;IACnC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;CACR,CAAC"}

package/dist/core/responses.js

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export const ApiErrorResponseSchema = z.object({
+    success: z.literal(false),
+    error: z.string(),
+    code: z.number(),
+    issues: z.array(z.object({ path: z.string(), message: z.string() })).optional()
+});
+export const ApiSuccessResponseSchema = (data) => z.object({
+    success: z.literal(true),
+    data
+});
+//# sourceMappingURL=responses.js.map

package/dist/core/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/core/responses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAgB,MAAM,KAAK,CAAC;AAEtC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC/E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAoB,IAAO,EAAE,EAAE,CACtE,CAAC,CAAC,MAAM,CAAC;IACR,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACxB,IAAI;CACJ,CAAC,CAAC"}

package/dist/sveltekit/apiHandler.d.ts

@@ -0,0 +1,23 @@
+import { type RequestHandler } from '@sveltejs/kit';
+import { type ZodType } from 'zod';
+import { type EndpointDefinition } from '../core/index.js';
+export type SvelteKitAdapterOptions<User = unknown, Event = Parameters<RequestHandler>[0]> = {
+    resolveUser?: (event: Event) => User | undefined | Promise<User | undefined>;
+    hasRole?: (user: User, role: string) => boolean | Promise<boolean>;
+    isAuthDisabled?: (event: Event) => boolean | Promise<boolean>;
+    onError?: (error: unknown, event: Event) => void | Promise<void>;
+};
+export declare const fail: (status: number, error: string, issues?: Array<{
+    path: string;
+    message: string;
+}>) => Response;
+/**
+ * SvelteKit-адаптер для EndpointDefinition.
+ *
+ * Адаптер отвечает только за механику фреймворка: извлечение RequestEvent,
+ * создание Response, преобразование ошибок валидации и опциональные хуки
+ * авторизации. Бизнес-логика авторизации и сессий остается в приложении.
+ */
+export declare const svelteKitApiHandler: <ParamsSchema extends ZodType | null = null, QuerySchema extends ZodType | null = null, BodySchema extends ZodType | null = null, Response = unknown, ResponseSchema extends ZodType | null = null, Role extends string = string, User = unknown>(endpoint: EndpointDefinition<ParamsSchema, QuerySchema, BodySchema, Response, ResponseSchema, Role, User, Parameters<RequestHandler>[0]>, options?: SvelteKitAdapterOptions<User>) => RequestHandler;
+export { svelteKitApiHandler as apiHandler };
+//# sourceMappingURL=apiHandler.d.ts.map

package/dist/sveltekit/apiHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiHandler.d.ts","sourceRoot":"","sources":["../../src/sveltekit/apiHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAK,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,EAGN,KAAK,kBAAkB,EAIvB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,uBAAuB,CAAC,IAAI,GAAG,OAAO,EAAE,KAAK,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI;IAC5F,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IAC7E,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE,CAAC;AASF,eAAO,MAAM,IAAI,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,EAAE,SAAS,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,aAIlG,CAAC;AAkBJ;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC/B,YAAY,SAAS,OAAO,GAAG,IAAI,GAAG,IAAI,EAC1C,WAAW,SAAS,OAAO,GAAG,IAAI,GAAG,IAAI,EACzC,UAAU,SAAS,OAAO,GAAG,IAAI,GAAG,IAAI,EACxC,QAAQ,GAAG,OAAO,EAClB,cAAc,SAAS,OAAO,GAAG,IAAI,GAAG,IAAI,EAC5C,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,IAAI,GAAG,OAAO,EAEd,UAAU,kBAAkB,CAC3B,YAAY,EACZ,WAAW,EACX,UAAU,EACV,QAAQ,EACR,cAAc,EACd,IAAI,EACJ,IAAI,EACJ,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAC7B,EACD,UAAS,uBAAuB,CAAC,IAAI,CAAM,KACzC,cA+EF,CAAC;AAEF,OAAO,EAAE,mBAAmB,IAAI,UAAU,EAAE,CAAC"}

package/dist/sveltekit/apiHandler.js

@@ -0,0 +1,105 @@
+import { json } from '@sveltejs/kit';
+import { z } from 'zod';
+import { ApiErrorResponseSchema, ApiKitError, registerEndpoint, toApiIssues, toCacheHeaders } from '../core/index.js';
+const parseJsonRequestBody = async (request) => {
+    const rawText = await request.text().catch(() => '');
+    const trimmed = rawText.trim();
+    if (!trimmed)
+        return undefined;
+    return JSON.parse(trimmed);
+};
+export const fail = (status, error, issues) => json(ApiErrorResponseSchema.parse({ success: false, error, code: status, issues }), {
+    status,
+    headers: toCacheHeaders('no-store')
+});
+const defaultResolveUser = (event) => event.locals.user;
+const defaultHasRole = (user, role) => {
+    const roles = user.roles;
+    return Array.isArray(roles) && roles.includes(role);
+};
+const defaultIsAuthDisabled = () => globalThis.process?.env
+    ?.DEMO_PUBLIC === '1';
+/**
+ * SvelteKit-адаптер для EndpointDefinition.
+ *
+ * Адаптер отвечает только за механику фреймворка: извлечение RequestEvent,
+ * создание Response, преобразование ошибок валидации и опциональные хуки
+ * авторизации. Бизнес-логика авторизации и сессий остается в приложении.
+ */
+export const svelteKitApiHandler = (endpoint, options = {}) => {
+    registerEndpoint(endpoint);
+    return async (event) => {
+        const cachePolicy = endpoint.cachePolicy ?? 'no-store';
+        const responseHeaders = toCacheHeaders(cachePolicy);
+        try {
+            const user = options.resolveUser
+                ? await options.resolveUser(event)
+                : defaultResolveUser(event);
+            const authDisabled = options.isAuthDisabled
+                ? await options.isAuthDisabled(event)
+                : defaultIsAuthDisabled();
+            if (!authDisabled && endpoint.requireAuth) {
+                if (!user)
+                    return fail(401, 'Unauthorized');
+                for (const role of endpoint.roles ?? []) {
+                    const allowed = options.hasRole
+                        ? await options.hasRole(user, role)
+                        : defaultHasRole(user, role);
+                    if (!allowed)
+                        return fail(403, 'Forbidden');
+                }
+            }
+            const paramsSchema = endpoint.paramsSchema;
+            const querySchema = endpoint.querySchema;
+            const bodySchema = endpoint.bodySchema;
+            const responseSchema = endpoint.responseSchema;
+            const parsedParams = paramsSchema ? paramsSchema.parse(event.params) : event.params;
+            const queryObject = Object.fromEntries(event.url.searchParams);
+            const parsedQuery = querySchema ? querySchema.parse(queryObject) : queryObject;
+            let parsedBody = undefined;
+            const contentType = event.request.headers.get('content-type') || '';
+            if (!contentType.includes('multipart/form-data')) {
+                const rawBody = await parseJsonRequestBody(event.request);
+                parsedBody = bodySchema ? bodySchema.parse(rawBody ?? {}) : rawBody;
+            }
+            const result = await endpoint.handler({
+                params: parsedParams,
+                query: parsedQuery,
+                body: parsedBody,
+                request: event.request,
+                user,
+                adapter: event
+            });
+            if (result instanceof Response) {
+                if (result.headers.has('cache-control'))
+                    return result;
+                const headers = new Headers(result.headers);
+                for (const [key, value] of Object.entries(responseHeaders))
+                    headers.set(key, value);
+                return new Response(result.body, {
+                    status: result.status,
+                    statusText: result.statusText,
+                    headers
+                });
+            }
+            const data = responseSchema ? responseSchema.parse(result) : result;
+            const status = endpoint.openapi.method === 'POST' ? 201 : endpoint.openapi.method === 'DELETE' ? 204 : 200;
+            if (status === 204)
+                return new Response(null, { status, headers: responseHeaders });
+            return json({ success: true, data }, { status, headers: responseHeaders });
+        }
+        catch (error) {
+            await options.onError?.(error, event);
+            if (error instanceof SyntaxError)
+                return fail(400, 'Invalid JSON body');
+            if (error instanceof z.ZodError)
+                return fail(400, 'Validation failed', toApiIssues(error));
+            if (error instanceof ApiKitError) {
+                return fail(error.status, error.expose ? error.message : 'Internal Server Error', error.issues);
+            }
+            return fail(500, error instanceof Error ? error.message : 'Internal Server Error');
+        }
+    };
+};
+export { svelteKitApiHandler as apiHandler };
+//# sourceMappingURL=apiHandler.js.map

package/dist/sveltekit/apiHandler.js.map

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

package/dist/sveltekit/index.d.ts

@@ -0,0 +1,2 @@
+export * from './apiHandler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sveltekit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sveltekit/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/sveltekit/index.js

@@ -0,0 +1,2 @@
+export * from './apiHandler.js';
+//# sourceMappingURL=index.js.map

package/dist/sveltekit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sveltekit/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,81 @@
+{
+	"name": "@varmdev/api-kit",
+	"version": "0.1.7",
+	"description": "Toolkit for typed API endpoints, Zod validation, OpenAPI generation and SvelteKit adapters.",
+	"type": "module",
+	"license": "MIT",
+	"main": "./dist/core/index.js",
+	"types": "./dist/core/index.d.ts",
+	"exports": {
+		"./core": {
+			"types": "./dist/core/index.d.ts",
+			"import": "./dist/core/index.js"
+		},
+		"./core/apiRegistry": {
+			"types": "./dist/core/apiRegistry.d.ts",
+			"import": "./dist/core/apiRegistry.js"
+		},
+		"./core/client": {
+			"types": "./dist/core/client.d.ts",
+			"import": "./dist/core/client.js"
+		},
+		"./core/query": {
+			"types": "./dist/core/query.d.ts",
+			"import": "./dist/core/query.js"
+		},
+		"./sveltekit": {
+			"types": "./dist/sveltekit/index.d.ts",
+			"import": "./dist/sveltekit/index.js"
+		},
+		"./sveltekit/apiHandler": {
+			"types": "./dist/sveltekit/apiHandler.d.ts",
+			"import": "./dist/sveltekit/apiHandler.js"
+		},
+		"./apiRegistry": {
+			"types": "./dist/core/apiRegistry.d.ts",
+			"import": "./dist/core/apiRegistry.js"
+		},
+		"./apiHandler": {
+			"types": "./dist/sveltekit/apiHandler.d.ts",
+			"import": "./dist/sveltekit/apiHandler.js"
+		},
+		"./client": {
+			"types": "./dist/core/client.d.ts",
+			"import": "./dist/core/client.js"
+		},
+		"./query": {
+			"types": "./dist/core/query.d.ts",
+			"import": "./dist/core/query.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"build": "tsc -p tsconfig.json",
+		"check": "tsc -p tsconfig.json --noEmit",
+		"prepare": "bun run build",
+		"prepack": "bun run build"
+	},
+	"peerDependencies": {
+		"@sveltejs/kit": ">=2.0.0",
+		"zod": ">=4.0.0"
+	},
+	"peerDependenciesMeta": {
+		"@sveltejs/kit": {
+			"optional": true
+		}
+	},
+	"dependencies": {
+		"@asteasolutions/zod-to-openapi": "^8.5.0"
+	},
+	"devDependencies": {
+		"@sveltejs/kit": "2.59.1",
+		"typescript": "^6.0.3",
+		"zod": "^4.4.3"
+	}
+}