@sylphx/contract 0.2.0

package/dist/endpoints/flags-admin.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Flags Admin endpoints — Console-plane feature-flag management.
+ * Mirrors `apps/api/src/server/platform/routes/flags.ts`.
+ *
+ * Production mount: `/flags/*`. `-admin` suffix distinguishes from the
+ * BaaS `flagsEndpoints` served on the standalone runtime at
+ * `{ref}.api.sylphx.com/flags/evaluate`.
+ */
+export declare const flagsAdminEndpoints: {
+    readonly list: import("../endpoint.js").Endpoint<"GET", "/flags", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        environmentId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        limit: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        offset: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        search: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        flags: import("effect/Schema").Array$<typeof import("effect/Schema").Unknown>;
+        total: typeof import("effect/Schema").Number;
+    }>>;
+    readonly create: import("../endpoint.js").Endpoint<"POST", "/flags", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        key: typeof import("effect/Schema").String;
+        name: typeof import("effect/Schema").String;
+        description: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        enabled: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        rolloutPercentage: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        targetPremiumOnly: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        targetAdminOnly: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        environmentId: import("effect/Schema").optional<import("effect/Schema").NullOr<typeof import("effect/Schema").String>>;
+        sortOrder: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+    }>, typeof import("effect/Schema").Unknown>;
+    readonly update: import("../endpoint.js").Endpoint<"PATCH", "/flags", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        id: typeof import("effect/Schema").String;
+        name: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        description: import("effect/Schema").optional<import("effect/Schema").NullOr<typeof import("effect/Schema").String>>;
+        enabled: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        rolloutPercentage: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+        targetPremiumOnly: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        targetAdminOnly: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        expectedVersion: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, typeof import("effect/Schema").Unknown>;
+    readonly delete: import("../endpoint.js").Endpoint<"DELETE", "/flags", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        id: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly reorder: import("../endpoint.js").Endpoint<"POST", "/flags/reorder", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        flagIds: import("effect/Schema").Array$<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly bulkUpdateEnabled: import("../endpoint.js").Endpoint<"POST", "/flags/bulk-update-enabled", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        flagIds: import("effect/Schema").Array$<typeof import("effect/Schema").String>;
+        enabled: typeof import("effect/Schema").Boolean;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+        updated: typeof import("effect/Schema").Number;
+    }>>;
+    readonly bulkDelete: import("../endpoint.js").Endpoint<"POST", "/flags/bulk-delete", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        flagIds: import("effect/Schema").Array$<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+        deleted: typeof import("effect/Schema").Number;
+    }>>;
+    readonly getServiceData: import("../endpoint.js").Endpoint<"GET", "/flags/projects/:id", import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, typeof import("effect/Schema").Unknown>;
+};
+//# sourceMappingURL=flags-admin.d.ts.map

package/dist/endpoints/flags-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags-admin.d.ts","sourceRoot":"","sources":["../../src/endpoints/flags-admin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsBH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEtB,CAAA"}

package/dist/endpoints/flags-admin.js

@@ -0,0 +1,84 @@
+/**
+ * Flags Admin endpoints — Console-plane feature-flag management.
+ * Mirrors `apps/api/src/server/platform/routes/flags.ts`.
+ *
+ * Production mount: `/flags/*`. `-admin` suffix distinguishes from the
+ * BaaS `flagsEndpoints` served on the standalone runtime at
+ * `{ref}.api.sylphx.com/flags/evaluate`.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { BulkDeleteFlagsInput, BulkDeleteFlagsResult, BulkUpdateEnabledInput, BulkUpdateEnabledResult, CreateFeatureFlagInput, CreateFeatureFlagResult, DeleteFeatureFlagInput, DeleteFeatureFlagResult, FlagsPaginationQuery, FlagsProjectIdParams, FlagsServiceDataResult, ListFeatureFlagsResult, ReorderFlagsInput, ReorderFlagsResult, UpdateFeatureFlagInput, UpdateFeatureFlagResult, } from '../schemas/flags-admin.js';
+export const flagsAdminEndpoints = {
+    list: defineEndpoint({
+        method: 'GET',
+        path: '/flags',
+        query: FlagsPaginationQuery,
+        response: ListFeatureFlagsResult,
+        plane: 'management',
+        summary: 'List feature flags for a project',
+        tags: ['flags-admin'],
+    }),
+    create: defineEndpoint({
+        method: 'POST',
+        path: '/flags',
+        body: CreateFeatureFlagInput,
+        response: CreateFeatureFlagResult,
+        plane: 'management',
+        summary: 'Create a feature flag',
+        tags: ['flags-admin'],
+    }),
+    update: defineEndpoint({
+        method: 'PATCH',
+        path: '/flags',
+        body: UpdateFeatureFlagInput,
+        response: UpdateFeatureFlagResult,
+        plane: 'management',
+        summary: 'Update a feature flag (with optional optimistic locking)',
+        tags: ['flags-admin'],
+    }),
+    delete: defineEndpoint({
+        method: 'DELETE',
+        path: '/flags',
+        body: DeleteFeatureFlagInput,
+        response: DeleteFeatureFlagResult,
+        plane: 'management',
+        summary: 'Delete a feature flag',
+        tags: ['flags-admin'],
+    }),
+    reorder: defineEndpoint({
+        method: 'POST',
+        path: '/flags/reorder',
+        body: ReorderFlagsInput,
+        response: ReorderFlagsResult,
+        plane: 'management',
+        summary: 'Reorder feature flags',
+        tags: ['flags-admin'],
+    }),
+    bulkUpdateEnabled: defineEndpoint({
+        method: 'POST',
+        path: '/flags/bulk-update-enabled',
+        body: BulkUpdateEnabledInput,
+        response: BulkUpdateEnabledResult,
+        plane: 'management',
+        summary: 'Bulk-toggle enabled state across many flags',
+        tags: ['flags-admin'],
+    }),
+    bulkDelete: defineEndpoint({
+        method: 'POST',
+        path: '/flags/bulk-delete',
+        body: BulkDeleteFlagsInput,
+        response: BulkDeleteFlagsResult,
+        plane: 'management',
+        summary: 'Bulk delete feature flags',
+        tags: ['flags-admin'],
+    }),
+    getServiceData: defineEndpoint({
+        method: 'GET',
+        path: '/flags/projects/:id',
+        params: FlagsProjectIdParams,
+        response: FlagsServiceDataResult,
+        plane: 'management',
+        summary: 'Get service-data overview for the flags dashboard',
+        tags: ['flags-admin'],
+    }),
+};

package/dist/endpoints/flags.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Feature Flag endpoints — BaaS plane. Server-side evaluation per
+ * `@sylphx/sdk/flags.ts`.
+ */
+export declare const flagsEndpoints: {
+    readonly evaluate: import("../endpoint.js").Endpoint<"POST", "/flags/evaluate", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        context: import("effect/Schema").optional<import("effect/Schema").Struct<{
+            userId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            anonymousId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            properties: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+        }>>;
+        keys: import("effect/Schema").optional<import("effect/Schema").Array$<typeof import("effect/Schema").String>>;
+    }>, import("effect/Schema").Struct<{
+        data: import("effect/Schema").Record$<typeof import("effect/Schema").String, import("effect/Schema").Struct<{
+            key: typeof import("effect/Schema").String;
+            enabled: typeof import("effect/Schema").Boolean;
+            variant: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            reason: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            payload: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+        }>>;
+    }>>;
+};
+//# sourceMappingURL=flags.d.ts.map

package/dist/endpoints/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/endpoints/flags.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;CAUjB,CAAA"}

package/dist/endpoints/flags.js

@@ -0,0 +1,17 @@
+/**
+ * Feature Flag endpoints — BaaS plane. Server-side evaluation per
+ * `@sylphx/sdk/flags.ts`.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { EvaluateFlagsInput, EvaluateFlagsResult } from '../schemas/flags.js';
+export const flagsEndpoints = {
+    evaluate: defineEndpoint({
+        method: 'POST',
+        path: '/flags/evaluate',
+        body: EvaluateFlagsInput,
+        response: EvaluateFlagsResult,
+        plane: 'baas',
+        summary: 'Evaluate one, many, or all feature flags for a targeting context',
+        tags: ['flags'],
+    }),
+};

package/dist/endpoints/github.d.ts

@@ -0,0 +1,30 @@
+/**
+ * GitHub endpoints — Console-plane repo ↔ environment wiring.
+ * Mirrors `apps/api/src/server/platform/routes/github.ts`.
+ *
+ * Production mount: `/github/*`.
+ */
+export declare const githubEndpoints: {
+    readonly connect: import("../endpoint.js").Endpoint<"POST", "/github/connect", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        envId: typeof import("effect/Schema").String;
+        repoFullName: typeof import("effect/Schema").String;
+        branch: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+        repoFullName: typeof import("effect/Schema").String;
+        branch: typeof import("effect/Schema").String;
+    }>>;
+    readonly getConnection: import("../endpoint.js").Endpoint<"GET", "/github/connect/:envId", import("effect/Schema").Struct<{
+        envId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        connected: typeof import("effect/Schema").Boolean;
+        repoFullName: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+        branch: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+    }>>;
+    readonly disconnect: import("../endpoint.js").Endpoint<"DELETE", "/github/connect/:envId", import("effect/Schema").Struct<{
+        envId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+};
+//# sourceMappingURL=github.d.ts.map

package/dist/endpoints/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/endpoints/github.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CA4BlB,CAAA"}

package/dist/endpoints/github.js

@@ -0,0 +1,37 @@
+/**
+ * GitHub endpoints — Console-plane repo ↔ environment wiring.
+ * Mirrors `apps/api/src/server/platform/routes/github.ts`.
+ *
+ * Production mount: `/github/*`.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { GithubConnectInput, GithubConnectionStatus, GithubConnectResult, GithubDisconnectResult, GithubEnvIdParams, } from '../schemas/github.js';
+export const githubEndpoints = {
+    connect: defineEndpoint({
+        method: 'POST',
+        path: '/github/connect',
+        body: GithubConnectInput,
+        response: GithubConnectResult,
+        plane: 'management',
+        summary: 'Connect a GitHub repository to an environment',
+        tags: ['github'],
+    }),
+    getConnection: defineEndpoint({
+        method: 'GET',
+        path: '/github/connect/:envId',
+        params: GithubEnvIdParams,
+        response: GithubConnectionStatus,
+        plane: 'management',
+        summary: 'Get GitHub connection status for an environment',
+        tags: ['github'],
+    }),
+    disconnect: defineEndpoint({
+        method: 'DELETE',
+        path: '/github/connect/:envId',
+        params: GithubEnvIdParams,
+        response: GithubDisconnectResult,
+        plane: 'management',
+        summary: 'Disconnect a GitHub repository from an environment',
+        tags: ['github'],
+    }),
+};

package/dist/endpoints/image-opt.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Image Optimisation endpoints — Management plane for URL signing + a
+ * public-plane forward route for the eventual imgproxy backend.
+ *
+ * Design reference: `docs/design/edge-functions-isr-image-opt.md` § 3.3 + § 6.
+ *
+ * Plane split:
+ *   - `management` — `POST /projects/:id/image-opt/sign` mints a signed URL
+ *     using the project's image-signing secret (server-side only, never
+ *     leaks into client bundles).
+ *   - Public forward: `GET /img/:signature/:params/:url` — stubbed in the
+ *     scaffold; declared here so the imgproxy infra PR can light it up
+ *     without touching the contract again.
+ */
+import { Schema } from 'effect';
+export declare const imageOptEndpoints: {
+    readonly sign: import("../endpoint.js").Endpoint<"POST", "/projects/:id/image-opt/sign", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        sourcePath: Schema.filter<typeof Schema.String>;
+        width: Schema.optional<typeof Schema.Number>;
+        height: Schema.optional<typeof Schema.Number>;
+        format: Schema.optional<Schema.Literal<["auto", "avif", "webp", "jpeg", "png"]>>;
+        resize: Schema.optional<Schema.Literal<["fit", "fill", "crop", "auto"]>>;
+        dpr: Schema.optional<typeof Schema.Number>;
+        quality: Schema.optional<typeof Schema.Number>;
+    }>, Schema.Struct<{
+        url: typeof Schema.String;
+        signature: typeof Schema.String;
+        params: typeof Schema.String;
+        expiresIn: Schema.NullOr<typeof Schema.Number>;
+    }>>;
+    readonly forward: import("../endpoint.js").Endpoint<"GET", "/img/:signature/:params/:url", Schema.Struct<{
+        signature: typeof Schema.String;
+        params: typeof Schema.String;
+        url: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        /** Scaffold response — replaced by the imgproxy forward once infra ships. */
+        pending: typeof Schema.Boolean;
+        message: typeof Schema.String;
+    }>>;
+};
+//# sourceMappingURL=image-opt.d.ts.map

package/dist/endpoints/image-opt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-opt.d.ts","sourceRoot":"","sources":["../../src/endpoints/image-opt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAU/B,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;QAkB3B,6EAA6E;;;;CAQtE,CAAA"}

package/dist/endpoints/image-opt.js

@@ -0,0 +1,44 @@
+/**
+ * Image Optimisation endpoints — Management plane for URL signing + a
+ * public-plane forward route for the eventual imgproxy backend.
+ *
+ * Design reference: `docs/design/edge-functions-isr-image-opt.md` § 3.3 + § 6.
+ *
+ * Plane split:
+ *   - `management` — `POST /projects/:id/image-opt/sign` mints a signed URL
+ *     using the project's image-signing secret (server-side only, never
+ *     leaks into client bundles).
+ *   - Public forward: `GET /img/:signature/:params/:url` — stubbed in the
+ *     scaffold; declared here so the imgproxy infra PR can light it up
+ *     without touching the contract again.
+ */
+import { Schema } from 'effect';
+import { defineEndpoint } from '../endpoint.js';
+import { ImageForwardParams, ImageOptimizationRequest, ImageOptimizationResult, } from '../schemas/image-opt.js';
+const ProjectPath = Schema.Struct({ id: Schema.String });
+export const imageOptEndpoints = {
+    sign: defineEndpoint({
+        method: 'POST',
+        path: '/projects/:id/image-opt/sign',
+        params: ProjectPath,
+        body: ImageOptimizationRequest,
+        response: ImageOptimizationResult,
+        plane: 'management',
+        summary: 'Generate a signed image-optimisation URL for a source path',
+        description: "Returns an `img.sylphx.app` URL signed with the project's image-signing secret. The secret itself is never exposed. Used by `@sylphx/sdk/nextjs` image-loader and by the `sylphx image-url` CLI.",
+        tags: ['image-opt'],
+    }),
+    forward: defineEndpoint({
+        method: 'GET',
+        path: '/img/:signature/:params/:url',
+        params: ImageForwardParams,
+        response: Schema.Struct({
+            /** Scaffold response — replaced by the imgproxy forward once infra ships. */
+            pending: Schema.Boolean,
+            message: Schema.String,
+        }),
+        plane: 'management',
+        summary: 'Forward a signed image request to the imgproxy backend (scaffold: returns pending)',
+        tags: ['image-opt'],
+    }),
+};

package/dist/endpoints/kv-admin.d.ts

@@ -0,0 +1,58 @@
+/**
+ * KV Admin endpoints — Console-plane operator dashboard.
+ * Mirrors `apps/api/src/server/platform/routes/kv.ts`.
+ *
+ * Production mount: `/kv/*`. Naming `-admin` to avoid collision with the
+ * BaaS `kvEndpoints` served by the standalone runtime at
+ * `{ref}.api.sylphx.com/sdk/kv/*`.
+ */
+export declare const kvAdminEndpoints: {
+    readonly getStatus: import("../endpoint.js").Endpoint<"GET", "/kv/status", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        available: typeof import("effect/Schema").Boolean;
+        provider: typeof import("effect/Schema").String;
+    }>>;
+    readonly list: import("../endpoint.js").Endpoint<"GET", "/kv", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        prefix: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        limit: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        keys: import("effect/Schema").Array$<typeof import("effect/Schema").String>;
+        count: typeof import("effect/Schema").Number;
+    }>>;
+    readonly getStats: import("../endpoint.js").Endpoint<"GET", "/kv/stats", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        totalKeys: typeof import("effect/Schema").Number;
+        storageBytes: typeof import("effect/Schema").Number;
+        operationsToday: typeof import("effect/Schema").Number;
+    }>>;
+    readonly get: import("../endpoint.js").Endpoint<"GET", "/kv/:key", import("effect/Schema").Struct<{
+        key: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        key: typeof import("effect/Schema").String;
+        value: import("effect/Schema").NullOr<typeof import("effect/Schema").Unknown>;
+        ttl: import("effect/Schema").NullOr<typeof import("effect/Schema").Number>;
+    }>>;
+    readonly set: import("../endpoint.js").Endpoint<"PUT", "/kv/:key", import("effect/Schema").Struct<{
+        key: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        value: typeof import("effect/Schema").Unknown;
+        ttl: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly delete: import("../endpoint.js").Endpoint<"DELETE", "/kv/:key", import("effect/Schema").Struct<{
+        key: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+    }>, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+        deleted: typeof import("effect/Schema").Number;
+    }>>;
+};
+//# sourceMappingURL=kv-admin.d.ts.map

package/dist/endpoints/kv-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv-admin.d.ts","sourceRoot":"","sources":["../../src/endpoints/kv-admin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DnB,CAAA"}

package/dist/endpoints/kv-admin.js

@@ -0,0 +1,69 @@
+/**
+ * KV Admin endpoints — Console-plane operator dashboard.
+ * Mirrors `apps/api/src/server/platform/routes/kv.ts`.
+ *
+ * Production mount: `/kv/*`. Naming `-admin` to avoid collision with the
+ * BaaS `kvEndpoints` served by the standalone runtime at
+ * `{ref}.api.sylphx.com/sdk/kv/*`.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { KvAdminDeleteResult, KvAdminGetResult, KvAdminKeyParams, KvAdminListQuery, KvAdminListResult, KvAdminProjectIdQuery, KvAdminSetInput, KvAdminSetResult, KvAdminStatsResult, KvAdminStatusResult, } from '../schemas/kv-admin.js';
+export const kvAdminEndpoints = {
+    getStatus: defineEndpoint({
+        method: 'GET',
+        path: '/kv/status',
+        query: KvAdminProjectIdQuery,
+        response: KvAdminStatusResult,
+        plane: 'management',
+        summary: 'Get KV service status (customer project)',
+        tags: ['kv-admin'],
+    }),
+    list: defineEndpoint({
+        method: 'GET',
+        path: '/kv',
+        query: KvAdminListQuery,
+        response: KvAdminListResult,
+        plane: 'management',
+        summary: 'List KV keys for a customer project',
+        tags: ['kv-admin'],
+    }),
+    getStats: defineEndpoint({
+        method: 'GET',
+        path: '/kv/stats',
+        query: KvAdminProjectIdQuery,
+        response: KvAdminStatsResult,
+        plane: 'management',
+        summary: 'Get KV usage stats for a customer project',
+        tags: ['kv-admin'],
+    }),
+    get: defineEndpoint({
+        method: 'GET',
+        path: '/kv/:key',
+        params: KvAdminKeyParams,
+        query: KvAdminProjectIdQuery,
+        response: KvAdminGetResult,
+        plane: 'management',
+        summary: 'Get a KV value (Console admin)',
+        tags: ['kv-admin'],
+    }),
+    set: defineEndpoint({
+        method: 'PUT',
+        path: '/kv/:key',
+        params: KvAdminKeyParams,
+        body: KvAdminSetInput,
+        response: KvAdminSetResult,
+        plane: 'management',
+        summary: 'Set a KV value (Console admin)',
+        tags: ['kv-admin'],
+    }),
+    delete: defineEndpoint({
+        method: 'DELETE',
+        path: '/kv/:key',
+        params: KvAdminKeyParams,
+        query: KvAdminProjectIdQuery,
+        response: KvAdminDeleteResult,
+        plane: 'management',
+        summary: 'Delete a KV value (Console admin)',
+        tags: ['kv-admin'],
+    }),
+};

package/dist/endpoints/kv.d.ts

@@ -0,0 +1,63 @@
+/**
+ * KV endpoints — BaaS plane key-value store. Paths mirror `@sylphx/sdk` `kv.ts`
+ * (served under `/sdk/kv/*` upstream on `<your-app>.api.sylphx.com`).
+ */
+import { Schema } from 'effect';
+export declare const kvEndpoints: {
+    readonly set: import("../endpoint.js").Endpoint<"POST", "/sdk/kv/set", Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        key: typeof Schema.String;
+        value: typeof Schema.Unknown;
+        ex: Schema.optional<typeof Schema.Number>;
+        nx: Schema.optional<typeof Schema.Boolean>;
+        xx: Schema.optional<typeof Schema.Boolean>;
+    }>, Schema.Struct<{
+        ok: typeof Schema.Boolean;
+    }>>;
+    readonly get: import("../endpoint.js").Endpoint<"GET", "/sdk/kv/get/:key", Schema.Struct<{
+        key: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        value: Schema.NullOr<typeof Schema.Unknown>;
+    }>>;
+    readonly delete: import("../endpoint.js").Endpoint<"DELETE", "/sdk/kv/delete/:key", Schema.Struct<{
+        key: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        deleted: typeof Schema.Number;
+    }>>;
+    readonly exists: import("../endpoint.js").Endpoint<"GET", "/sdk/kv/exists/:key", Schema.Struct<{
+        key: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        exists: typeof Schema.Boolean;
+    }>>;
+    readonly incr: import("../endpoint.js").Endpoint<"POST", "/sdk/kv/incr", Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        key: typeof Schema.String;
+        by: Schema.optional<typeof Schema.Number>;
+    }>, Schema.Struct<{
+        value: typeof Schema.Number;
+    }>>;
+    readonly expire: import("../endpoint.js").Endpoint<"POST", "/sdk/kv/expire", Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        key: typeof Schema.String;
+        seconds: typeof Schema.Number;
+    }>, Schema.Struct<{
+        ok: typeof Schema.Boolean;
+    }>>;
+    readonly rateLimit: import("../endpoint.js").Endpoint<"POST", "/sdk/kv/ratelimit", Schema.Schema.AnyNoContext | undefined, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        identifier: typeof Schema.String;
+        limit: typeof Schema.Number;
+        window: typeof Schema.Number;
+    }>, Schema.Struct<{
+        success: typeof Schema.Boolean;
+        limit: typeof Schema.Number;
+        remaining: typeof Schema.Number;
+        reset: typeof Schema.Number;
+    }>>;
+    readonly scan: import("../endpoint.js").Endpoint<"GET", "/sdk/kv/scan", Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        pattern: Schema.optional<typeof Schema.String>;
+        cursor: Schema.optional<typeof Schema.String>;
+        count: Schema.optional<typeof Schema.String>;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        keys: Schema.Array$<typeof Schema.String>;
+        nextCursor: typeof Schema.String;
+        done: typeof Schema.Boolean;
+    }>>;
+};
+//# sourceMappingURL=kv.d.ts.map

package/dist/endpoints/kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../../src/endpoints/kv.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAmB/B,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyEd,CAAA"}