@sylphx/contract 0.2.0

package/dist/endpoints/email.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Email endpoints — BaaS plane. Paths mirror `@sylphx/sdk/email.ts`.
+ */
+export declare const emailEndpoints: {
+    readonly isConfigured: import("../endpoint.js").Endpoint<"GET", "/email/configured", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, typeof import("effect/Schema").Boolean>;
+    readonly send: import("../endpoint.js").Endpoint<"POST", "/email/send", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        to: typeof import("effect/Schema").String;
+        subject: typeof import("effect/Schema").String;
+        html: typeof import("effect/Schema").String;
+        text: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        replyTo: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        fromEmail: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        fromName: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+        headers: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").String>>;
+    }>, import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly sendTemplated: import("../endpoint.js").Endpoint<"POST", "/email/send-templated", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        template: import("effect/Schema").Literal<["welcome", "verification", "password_reset", "security_alert"]>;
+        to: typeof import("effect/Schema").String;
+        data: import("effect/Schema").optional<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+    }>, import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly sendToUser: import("../endpoint.js").Endpoint<"POST", "/email/send-to-user", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        userId: typeof import("effect/Schema").String;
+        subject: typeof import("effect/Schema").String;
+        html: typeof import("effect/Schema").String;
+        text: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        id: typeof import("effect/Schema").String;
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+};
+//# sourceMappingURL=email.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/endpoints/email.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCjB,CAAA"}

package/dist/endpoints/email.js

@@ -0,0 +1,42 @@
+/**
+ * Email endpoints — BaaS plane. Paths mirror `@sylphx/sdk/email.ts`.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { EmailConfiguredResult, SendEmailInput, SendEmailResult, SendEmailToUserInput, SendTemplatedEmailInput, } from '../schemas/email.js';
+export const emailEndpoints = {
+    isConfigured: defineEndpoint({
+        method: 'GET',
+        path: '/email/configured',
+        response: EmailConfiguredResult,
+        plane: 'baas',
+        summary: 'Whether the app has an email sender configured',
+        tags: ['email'],
+    }),
+    send: defineEndpoint({
+        method: 'POST',
+        path: '/email/send',
+        body: SendEmailInput,
+        response: SendEmailResult,
+        plane: 'baas',
+        summary: 'Send a one-off transactional email',
+        tags: ['email'],
+    }),
+    sendTemplated: defineEndpoint({
+        method: 'POST',
+        path: '/email/send-templated',
+        body: SendTemplatedEmailInput,
+        response: SendEmailResult,
+        plane: 'baas',
+        summary: 'Send a templated transactional email (welcome/verification/etc.)',
+        tags: ['email'],
+    }),
+    sendToUser: defineEndpoint({
+        method: 'POST',
+        path: '/email/send-to-user',
+        body: SendEmailToUserInput,
+        response: SendEmailResult,
+        plane: 'baas',
+        summary: 'Send an email to a user by their Sylphx user ID',
+        tags: ['email'],
+    }),
+};

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

@@ -0,0 +1,98 @@
+/**
+ * Engagement Admin endpoints — Console-plane gamification config + overrides
+ * + stats. Mirrors `apps/api/src/server/platform/routes/engagement.ts`.
+ *
+ * Production mount: `/engagement/*`.
+ */
+export declare const engagementAdminEndpoints: {
+    readonly getConfig: import("../endpoint.js").Endpoint<"GET", "/engagement/config", 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<{
+        exists: typeof import("effect/Schema").Boolean;
+        base: import("effect/Schema").Struct<{
+            streaks: import("effect/Schema").Array$<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+            leaderboards: import("effect/Schema").Array$<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+            achievements: import("effect/Schema").Array$<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+            achievementCategories: import("effect/Schema").Array$<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+        }>;
+        resolved: import("effect/Schema").Struct<{
+            streaks: import("effect/Schema").Array$<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+            leaderboards: import("effect/Schema").Array$<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+            achievements: import("effect/Schema").Array$<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+        }>;
+        overrides: import("effect/Schema").NullOr<import("effect/Schema").Record$<typeof import("effect/Schema").String, typeof import("effect/Schema").Unknown>>;
+        lastSyncedAt: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+    }>>;
+    readonly updateStreakOverride: import("../endpoint.js").Endpoint<"PATCH", "/engagement/streaks/override", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        streakId: typeof import("effect/Schema").String;
+        override: import("effect/Schema").Struct<{
+            name: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            description: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            gracePeriodHours: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+            maxValue: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+            resetOnMiss: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+            enabled: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        }>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly updateLeaderboardOverride: import("../endpoint.js").Endpoint<"PATCH", "/engagement/leaderboards/override", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        leaderboardId: typeof import("effect/Schema").String;
+        override: import("effect/Schema").Struct<{
+            name: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            description: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            maxEntries: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+            sortDirection: import("effect/Schema").optional<import("effect/Schema").Literal<["asc", "desc"]>>;
+            enabled: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        }>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly updateAchievementOverride: import("../endpoint.js").Endpoint<"PATCH", "/engagement/achievements/override", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        achievementId: typeof import("effect/Schema").String;
+        override: import("effect/Schema").Struct<{
+            name: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            description: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            unlockedDescription: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+            points: import("effect/Schema").optional<typeof import("effect/Schema").Number>;
+            tier: import("effect/Schema").optional<import("effect/Schema").Literal<["bronze", "silver", "gold", "platinum", "diamond"]>>;
+            secret: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+            enabled: import("effect/Schema").optional<typeof import("effect/Schema").Boolean>;
+        }>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly clearOverrides: import("../endpoint.js").Endpoint<"POST", "/engagement/overrides/clear", import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Schema.AnyNoContext | undefined, import("effect/Schema").Struct<{
+        projectId: typeof import("effect/Schema").String;
+        entityType: import("effect/Schema").optional<import("effect/Schema").Literal<["streak", "leaderboard", "achievement", "all"]>>;
+        entityId: import("effect/Schema").optional<typeof import("effect/Schema").String>;
+    }>, import("effect/Schema").Struct<{
+        success: typeof import("effect/Schema").Boolean;
+    }>>;
+    readonly getStats: import("../endpoint.js").Endpoint<"GET", "/engagement/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<{
+        config: import("effect/Schema").Struct<{
+            exists: typeof import("effect/Schema").Boolean;
+            lastSyncedAt: import("effect/Schema").NullOr<typeof import("effect/Schema").String>;
+            streakCount: typeof import("effect/Schema").Number;
+            leaderboardCount: typeof import("effect/Schema").Number;
+            achievementCount: typeof import("effect/Schema").Number;
+        }>;
+        streaks: import("effect/Schema").Struct<{
+            totalUsers: typeof import("effect/Schema").Number;
+            activeStreaks: typeof import("effect/Schema").Number;
+        }>;
+        leaderboards: import("effect/Schema").Struct<{
+            totalParticipants: typeof import("effect/Schema").Number;
+        }>;
+        achievements: import("effect/Schema").Struct<{
+            totalProgress: typeof import("effect/Schema").Number;
+            totalUnlocked: typeof import("effect/Schema").Number;
+        }>;
+    }>>;
+};
+//# sourceMappingURL=engagement-admin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engagement-admin.d.ts","sourceRoot":"","sources":["../../src/endpoints/engagement-admin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuD3B,CAAA"}

package/dist/endpoints/engagement-admin.js

@@ -0,0 +1,64 @@
+/**
+ * Engagement Admin endpoints — Console-plane gamification config + overrides
+ * + stats. Mirrors `apps/api/src/server/platform/routes/engagement.ts`.
+ *
+ * Production mount: `/engagement/*`.
+ */
+import { defineEndpoint } from '../endpoint.js';
+import { ClearOverridesInput, EngagementProjectQuery, EngagementSuccessResult, GetEngagementConfigResult, GetEngagementStatsResult, UpdateAchievementOverrideInput, UpdateLeaderboardOverrideInput, UpdateStreakOverrideInput, } from '../schemas/engagement-admin.js';
+export const engagementAdminEndpoints = {
+    getConfig: defineEndpoint({
+        method: 'GET',
+        path: '/engagement/config',
+        query: EngagementProjectQuery,
+        response: GetEngagementConfigResult,
+        plane: 'management',
+        summary: 'Get engagement config (base + resolved + overrides) for a project',
+        tags: ['engagement-admin'],
+    }),
+    updateStreakOverride: defineEndpoint({
+        method: 'PATCH',
+        path: '/engagement/streaks/override',
+        body: UpdateStreakOverrideInput,
+        response: EngagementSuccessResult,
+        plane: 'management',
+        summary: 'Apply a Console override to a streak configuration',
+        tags: ['engagement-admin'],
+    }),
+    updateLeaderboardOverride: defineEndpoint({
+        method: 'PATCH',
+        path: '/engagement/leaderboards/override',
+        body: UpdateLeaderboardOverrideInput,
+        response: EngagementSuccessResult,
+        plane: 'management',
+        summary: 'Apply a Console override to a leaderboard configuration',
+        tags: ['engagement-admin'],
+    }),
+    updateAchievementOverride: defineEndpoint({
+        method: 'PATCH',
+        path: '/engagement/achievements/override',
+        body: UpdateAchievementOverrideInput,
+        response: EngagementSuccessResult,
+        plane: 'management',
+        summary: 'Apply a Console override to an achievement configuration',
+        tags: ['engagement-admin'],
+    }),
+    clearOverrides: defineEndpoint({
+        method: 'POST',
+        path: '/engagement/overrides/clear',
+        body: ClearOverridesInput,
+        response: EngagementSuccessResult,
+        plane: 'management',
+        summary: 'Clear Console overrides to reset to code-defined defaults',
+        tags: ['engagement-admin'],
+    }),
+    getStats: defineEndpoint({
+        method: 'GET',
+        path: '/engagement/stats',
+        query: EngagementProjectQuery,
+        response: GetEngagementStatsResult,
+        plane: 'management',
+        summary: 'Get engagement statistics across streaks / leaderboards / achievements',
+        tags: ['engagement-admin'],
+    }),
+};

package/dist/endpoints/env-vars.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Environment variables endpoints — list / set / delete. Production mounts
+ * these under `/projects/:id/env-vars` in the management plane (ADR-084 Wave
+ * 2b). Both shared (env-level) and per-service scopes share one path,
+ * distinguished by the optional `serviceId` query/body field.
+ *
+ * Mirrors `apps/api/src/server/platform/routes/management/projects/env-vars.ts`.
+ */
+import { Schema } from 'effect';
+export declare const envVarsEndpoints: {
+    readonly list: import("../endpoint.js").Endpoint<"GET", "/projects/:id/env-vars", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Struct<{
+        envType: Schema.optional<typeof Schema.String>;
+        envId: Schema.optional<typeof Schema.String>;
+        serviceId: Schema.optional<typeof Schema.String>;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        object: Schema.Literal<["list"]>;
+        envId: typeof Schema.String;
+        envType: typeof Schema.String;
+        scope: Schema.Literal<["environment", "service"]>;
+        serviceId: Schema.optional<typeof Schema.String>;
+        data: Schema.Array$<Schema.Struct<{
+            key: typeof Schema.String;
+            value: Schema.optional<typeof Schema.String>;
+            isSecret: Schema.optional<typeof Schema.Boolean>;
+            secret: Schema.optional<typeof Schema.Boolean>;
+        }>>;
+    }>>;
+    readonly set: import("../endpoint.js").Endpoint<"POST", "/projects/:id/env-vars", Schema.Struct<{
+        id: typeof Schema.String;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        envType: Schema.optional<typeof Schema.String>;
+        envId: Schema.optional<typeof Schema.String>;
+        serviceId: Schema.optional<typeof Schema.String>;
+        vars: Schema.Array$<Schema.Struct<{
+            key: typeof Schema.String;
+            value: typeof Schema.String;
+            secret: Schema.optional<typeof Schema.Boolean>;
+        }>>;
+    }>, Schema.Struct<{
+        envId: typeof Schema.String;
+        envType: typeof Schema.String;
+        scope: Schema.Literal<["environment", "service"]>;
+        serviceId: Schema.NullOr<typeof Schema.String>;
+        succeeded: typeof Schema.Number;
+        failed: typeof Schema.Number;
+        queued: typeof Schema.Boolean;
+        generation: Schema.optional<Schema.NullOr<typeof Schema.Number>>;
+        errors: Schema.optional<Schema.Array$<typeof Schema.String>>;
+    }>>;
+    readonly delete: import("../endpoint.js").Endpoint<"DELETE", "/projects/:id/env-vars/:key", Schema.Struct<{
+        id: typeof Schema.String;
+        key: typeof Schema.String;
+    }>, Schema.Struct<{
+        envType: Schema.optional<typeof Schema.String>;
+        envId: Schema.optional<typeof Schema.String>;
+        serviceId: Schema.optional<typeof Schema.String>;
+    }>, Schema.Schema.AnyNoContext | undefined, Schema.Struct<{
+        deleted: typeof Schema.Boolean;
+        key: typeof Schema.String;
+        scope: Schema.Literal<["environment", "service"]>;
+        serviceId: Schema.NullOr<typeof Schema.String>;
+    }>>;
+};
+//# sourceMappingURL=env-vars.d.ts.map

package/dist/endpoints/env-vars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-vars.d.ts","sourceRoot":"","sources":["../../src/endpoints/env-vars.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAkB/B,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BnB,CAAA"}

package/dist/endpoints/env-vars.js

@@ -0,0 +1,47 @@
+/**
+ * Environment variables endpoints — list / set / delete. Production mounts
+ * these under `/projects/:id/env-vars` in the management plane (ADR-084 Wave
+ * 2b). Both shared (env-level) and per-service scopes share one path,
+ * distinguished by the optional `serviceId` query/body field.
+ *
+ * Mirrors `apps/api/src/server/platform/routes/management/projects/env-vars.ts`.
+ */
+import { Schema } from 'effect';
+import { defineEndpoint } from '../endpoint.js';
+import { DeleteEnvVarResult, EnvVarListResult, SetEnvVarsInput, SetEnvVarsResult, } from '../schemas/env-var.js';
+const ProjectIdPath = Schema.Struct({ id: Schema.String });
+const ProjectKeyPath = Schema.Struct({ id: Schema.String, key: Schema.String });
+const EnvVarsQuery = Schema.Struct({
+    envType: Schema.optional(Schema.String),
+    envId: Schema.optional(Schema.String),
+    serviceId: Schema.optional(Schema.String),
+});
+export const envVarsEndpoints = {
+    list: defineEndpoint({
+        method: 'GET',
+        path: '/projects/:id/env-vars',
+        params: ProjectIdPath,
+        query: EnvVarsQuery,
+        response: EnvVarListResult,
+        summary: 'List env var keys for a project/environment (values are write-only)',
+        tags: ['env-vars'],
+    }),
+    set: defineEndpoint({
+        method: 'POST',
+        path: '/projects/:id/env-vars',
+        params: ProjectIdPath,
+        body: SetEnvVarsInput,
+        response: SetEnvVarsResult,
+        summary: 'Upsert one or more env vars (env-level or per-service)',
+        tags: ['env-vars'],
+    }),
+    delete: defineEndpoint({
+        method: 'DELETE',
+        path: '/projects/:id/env-vars/:key',
+        params: ProjectKeyPath,
+        query: EnvVarsQuery,
+        response: DeleteEnvVarResult,
+        summary: 'Delete an env var by key',
+        tags: ['env-vars'],
+    }),
+};