@sylphx/contract 0.2.0

package/dist/schemas/experiments.js

@@ -0,0 +1,150 @@
+/**
+ * Experiments — schemas for A/B testing Console surface.
+ * Mirrors `routes/experiments/**`.
+ *
+ * Plane: `management`. Shapes mirror the existing legacy Zod schemas in
+ * `apps/api/src/server/platform/schemas/experiments.ts` so the Console UI
+ * keeps working without adapter changes.
+ */
+import { Schema } from 'effect';
+export const ExperimentStatus = Schema.Literal('draft', 'running', 'paused', 'concluded', 'archived');
+export const ExperimentStatsMethod = Schema.Literal('bayesian', 'frequentist');
+export const ExperimentMetricType = Schema.Literal('conversion', 'count', 'average', 'sum', 'percentile');
+export const ExperimentGuardrailAction = Schema.Literal('pause', 'alert');
+export const ExperimentVariant = Schema.Struct({
+    key: Schema.String,
+    name: Schema.String,
+    weight: Schema.Number,
+    payload: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
+});
+export const ExperimentMetric = Schema.Struct({
+    event: Schema.String,
+    type: ExperimentMetricType,
+    property: Schema.optional(Schema.String),
+    percentile: Schema.optional(Schema.Number),
+});
+export const ExperimentGuardrail = Schema.Struct({
+    metric: ExperimentMetric,
+    threshold: Schema.Number,
+    action: ExperimentGuardrailAction,
+});
+export const Experiment = Schema.Struct({
+    id: Schema.String,
+    projectId: Schema.String,
+    environmentId: Schema.NullOr(Schema.String),
+    key: Schema.String,
+    name: Schema.String,
+    description: Schema.NullOr(Schema.String),
+    hypothesis: Schema.NullOr(Schema.String),
+    status: ExperimentStatus,
+    variants: Schema.Array(ExperimentVariant),
+    primaryMetric: ExperimentMetric,
+    secondaryMetrics: Schema.NullOr(Schema.Array(ExperimentMetric)),
+    guardrails: Schema.NullOr(Schema.Array(ExperimentGuardrail)),
+    statsMethod: ExperimentStatsMethod,
+    confidenceLevel: Schema.Number,
+    minimumSampleSize: Schema.NullOr(Schema.Number),
+    minimumDurationDays: Schema.NullOr(Schema.Number),
+    winningVariant: Schema.NullOr(Schema.String),
+    startedAt: Schema.NullOr(Schema.String),
+    pausedAt: Schema.NullOr(Schema.String),
+    concludedAt: Schema.NullOr(Schema.String),
+    createdBy: Schema.NullOr(Schema.String),
+    createdAt: Schema.String,
+    updatedAt: Schema.NullOr(Schema.String),
+});
+export const ExperimentWithStats = Schema.Struct({
+    ...Experiment.fields,
+    stats: Schema.Struct({
+        exposures: Schema.Array(Schema.Struct({ variant: Schema.String, count: Schema.Number })),
+        conversions: Schema.Array(Schema.Struct({ variant: Schema.String, event: Schema.String, count: Schema.Number })),
+    }),
+});
+// ── Params / Query ─────────────────────────────────────────────────────────
+export const ExperimentIdParams = Schema.Struct({
+    projectId: Schema.String,
+    experimentId: Schema.String,
+});
+export const ListExperimentsQuery = Schema.Struct({
+    projectId: Schema.String,
+    status: Schema.optional(ExperimentStatus),
+    limit: Schema.optional(Schema.String),
+    offset: Schema.optional(Schema.String),
+});
+// ── Bodies ─────────────────────────────────────────────────────────────────
+export const CreateExperimentInput = Schema.Struct({
+    projectId: Schema.String,
+    key: Schema.String,
+    name: Schema.String,
+    description: Schema.optional(Schema.String),
+    hypothesis: Schema.optional(Schema.String),
+    variants: Schema.Array(ExperimentVariant),
+    primaryMetric: ExperimentMetric,
+    secondaryMetrics: Schema.optional(Schema.Array(ExperimentMetric)),
+    guardrails: Schema.optional(Schema.Array(ExperimentGuardrail)),
+    statsMethod: Schema.optional(ExperimentStatsMethod),
+    confidenceLevel: Schema.optional(Schema.Number),
+    minimumSampleSize: Schema.optional(Schema.Number),
+    minimumDurationDays: Schema.optional(Schema.Number),
+    environmentKey: Schema.optional(Schema.String),
+});
+export const UpdateExperimentInput = Schema.Struct({
+    name: Schema.optional(Schema.String),
+    description: Schema.optional(Schema.String),
+    hypothesis: Schema.optional(Schema.String),
+    variants: Schema.optional(Schema.Array(ExperimentVariant)),
+    secondaryMetrics: Schema.optional(Schema.Array(ExperimentMetric)),
+    guardrails: Schema.optional(Schema.Array(ExperimentGuardrail)),
+    minimumSampleSize: Schema.optional(Schema.Number),
+    minimumDurationDays: Schema.optional(Schema.Number),
+});
+export const ConcludeExperimentInput = Schema.Struct({
+    winningVariant: Schema.optional(Schema.String),
+});
+// ── Responses ──────────────────────────────────────────────────────────────
+export const ListExperimentsResult = Schema.Struct({
+    experiments: Schema.Array(Experiment),
+    total: Schema.Number,
+});
+/** `GET /experiments/:id` — single experiment detail with variants + stats. */
+export const GetExperimentResult = ExperimentWithStats;
+/** `POST /experiments` — returns the created experiment detail. */
+export const CreateExperimentResult = ExperimentWithStats;
+/** `PATCH /experiments/:id` — returns the updated experiment. */
+export const UpdateExperimentResult = ExperimentWithStats;
+/** Start / pause / conclude action — standard success envelope. */
+export const ExperimentActionResult = Schema.Struct({
+    success: Schema.Boolean,
+});
+export const DeleteExperimentResult = Schema.Struct({ success: Schema.Boolean });
+export const ExperimentVariantResult = Schema.Struct({
+    key: Schema.String,
+    name: Schema.String,
+    exposures: Schema.Number,
+    conversions: Schema.Number,
+    conversionRate: Schema.Number,
+    confidenceInterval: Schema.Struct({ lower: Schema.Number, upper: Schema.Number }),
+    relativeLift: Schema.Number,
+    probabilityToBeBest: Schema.Number,
+});
+export const GetExperimentResultsResult = Schema.Struct({
+    experiment: Schema.Struct({
+        id: Schema.String,
+        key: Schema.String,
+        name: Schema.String,
+        status: ExperimentStatus,
+        startedAt: Schema.NullOr(Schema.String),
+        concludedAt: Schema.NullOr(Schema.String),
+        winningVariant: Schema.NullOr(Schema.String),
+    }),
+    primaryMetric: Schema.Struct({ event: Schema.String, type: ExperimentMetricType }),
+    variants: Schema.Array(ExperimentVariantResult),
+    analysis: Schema.Struct({
+        totalExposures: Schema.Number,
+        isSignificant: Schema.Boolean,
+        confidence: Schema.Number,
+        winner: Schema.NullOr(Schema.String),
+        canConclude: Schema.Boolean,
+        blockers: Schema.Array(Schema.String),
+    }),
+});

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

@@ -0,0 +1,112 @@
+/**
+ * Flags Admin — schemas for Console-plane feature-flag management.
+ * Mirrors `routes/flags.ts`.
+ *
+ * Plane: `management`. Distinct from BaaS `flagsEndpoints` (server-side
+ * evaluation served by the standalone runtime).
+ *
+ * Response shapes use `Schema.Unknown` for large, storage-shape fields
+ * (flag records with nested targeting rules, env-scoped overrides) — the
+ * handler-side types remain the authoritative shape. Following the
+ * newsletter `StepConfig: Schema.Unknown` precedent established in Wave 3C.
+ */
+import { Schema } from 'effect';
+export declare const FlagsProjectIdParams: Schema.Struct<{
+    id: typeof Schema.String;
+}>;
+export type FlagsProjectIdParams = typeof FlagsProjectIdParams.Type;
+export declare const FlagsPaginationQuery: Schema.Struct<{
+    projectId: typeof Schema.String;
+    environmentId: Schema.optional<typeof Schema.String>;
+    limit: Schema.optional<typeof Schema.String>;
+    offset: Schema.optional<typeof Schema.String>;
+    search: Schema.optional<typeof Schema.String>;
+}>;
+export type FlagsPaginationQuery = typeof FlagsPaginationQuery.Type;
+export declare const FlagsFeatureFlag: typeof Schema.Unknown;
+export type FlagsFeatureFlag = {
+    [k: string]: any;
+};
+/** Alias for consumers migrating from api-types/schemas — stays opaque. */
+export declare const FeatureFlag: typeof Schema.Unknown;
+export type FeatureFlag = FlagsFeatureFlag;
+export declare const SerializedFlag: typeof Schema.Unknown;
+export type SerializedFlag = FlagsFeatureFlag;
+export declare const ListFeatureFlagsResult: Schema.Struct<{
+    flags: Schema.Array$<typeof Schema.Unknown>;
+    total: typeof Schema.Number;
+}>;
+export type ListFeatureFlagsResult = typeof ListFeatureFlagsResult.Type;
+export declare const CreateFeatureFlagInput: Schema.Struct<{
+    projectId: typeof Schema.String;
+    key: typeof Schema.String;
+    name: typeof Schema.String;
+    description: Schema.optional<typeof Schema.String>;
+    enabled: Schema.optional<typeof Schema.Boolean>;
+    rolloutPercentage: Schema.optional<typeof Schema.Number>;
+    targetPremiumOnly: Schema.optional<typeof Schema.Boolean>;
+    targetAdminOnly: Schema.optional<typeof Schema.Boolean>;
+    environmentId: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    sortOrder: Schema.optional<typeof Schema.Number>;
+}>;
+export type CreateFeatureFlagInput = typeof CreateFeatureFlagInput.Type;
+export declare const CreateFeatureFlagResult: typeof Schema.Unknown;
+export type CreateFeatureFlagResult = typeof FlagsFeatureFlag.Type;
+export declare const UpdateFeatureFlagInput: Schema.Struct<{
+    projectId: typeof Schema.String;
+    id: typeof Schema.String;
+    name: Schema.optional<typeof Schema.String>;
+    description: Schema.optional<Schema.NullOr<typeof Schema.String>>;
+    enabled: Schema.optional<typeof Schema.Boolean>;
+    rolloutPercentage: Schema.optional<typeof Schema.Number>;
+    targetPremiumOnly: Schema.optional<typeof Schema.Boolean>;
+    targetAdminOnly: Schema.optional<typeof Schema.Boolean>;
+    expectedVersion: Schema.optional<typeof Schema.String>;
+}>;
+export type UpdateFeatureFlagInput = typeof UpdateFeatureFlagInput.Type;
+export declare const UpdateFeatureFlagResult: typeof Schema.Unknown;
+export type UpdateFeatureFlagResult = typeof FlagsFeatureFlag.Type;
+export declare const DeleteFeatureFlagInput: Schema.Struct<{
+    projectId: typeof Schema.String;
+    id: typeof Schema.String;
+}>;
+export type DeleteFeatureFlagInput = typeof DeleteFeatureFlagInput.Type;
+export declare const DeleteFeatureFlagResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+}>;
+export type DeleteFeatureFlagResult = typeof DeleteFeatureFlagResult.Type;
+export declare const ReorderFlagsInput: Schema.Struct<{
+    projectId: typeof Schema.String;
+    flagIds: Schema.Array$<typeof Schema.String>;
+}>;
+export type ReorderFlagsInput = typeof ReorderFlagsInput.Type;
+export declare const ReorderFlagsResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+}>;
+export type ReorderFlagsResult = typeof ReorderFlagsResult.Type;
+export declare const BulkUpdateEnabledInput: Schema.Struct<{
+    projectId: typeof Schema.String;
+    flagIds: Schema.Array$<typeof Schema.String>;
+    enabled: typeof Schema.Boolean;
+}>;
+export type BulkUpdateEnabledInput = typeof BulkUpdateEnabledInput.Type;
+export declare const BulkUpdateEnabledResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+    updated: typeof Schema.Number;
+}>;
+export type BulkUpdateEnabledResult = typeof BulkUpdateEnabledResult.Type;
+export declare const BulkDeleteFlagsInput: Schema.Struct<{
+    projectId: typeof Schema.String;
+    flagIds: Schema.Array$<typeof Schema.String>;
+}>;
+export type BulkDeleteFlagsInput = typeof BulkDeleteFlagsInput.Type;
+export declare const BulkDeleteFlagsResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+    deleted: typeof Schema.Number;
+}>;
+export type BulkDeleteFlagsResult = typeof BulkDeleteFlagsResult.Type;
+export declare const FlagsServiceDataResult: typeof Schema.Unknown;
+export type FlagsServiceDataResult = {
+    [k: string]: any;
+};
+//# sourceMappingURL=flags-admin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flags-admin.d.ts","sourceRoot":"","sources":["../../src/schemas/flags-admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,eAAO,MAAM,oBAAoB;;EAAuC,CAAA;AACxE,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAEnE,eAAO,MAAM,oBAAoB;;;;;;EAM/B,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAInE,eAAO,MAAM,gBAAgB,uBAAiB,CAAA;AAE9C,MAAM,MAAM,gBAAgB,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAA;AAEnD,2EAA2E;AAC3E,eAAO,MAAM,WAAW,uBAAmB,CAAA;AAC3C,MAAM,MAAM,WAAW,GAAG,gBAAgB,CAAA;AAC1C,eAAO,MAAM,cAAc,uBAAmB,CAAA;AAC9C,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAA;AAE7C,eAAO,MAAM,sBAAsB;;;EAGjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AAEvE,eAAO,MAAM,sBAAsB;;;;;;;;;;;EAWjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AAEvE,eAAO,MAAM,uBAAuB,uBAAmB,CAAA;AACvD,MAAM,MAAM,uBAAuB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;AAElE,eAAO,MAAM,sBAAsB;;;;;;;;;;EAUjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AAEvE,eAAO,MAAM,uBAAuB,uBAAmB,CAAA;AACvD,MAAM,MAAM,uBAAuB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;AAElE,eAAO,MAAM,sBAAsB;;;EAGjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AAEvE,eAAO,MAAM,uBAAuB;;EAA6C,CAAA;AACjF,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA;AAEzE,eAAO,MAAM,iBAAiB;;;EAG5B,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAE7D,eAAO,MAAM,kBAAkB;;EAA6C,CAAA;AAC5E,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAE/D,eAAO,MAAM,sBAAsB;;;;EAIjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AAEvE,eAAO,MAAM,uBAAuB;;;EAGlC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA;AAEzE,eAAO,MAAM,oBAAoB;;;EAG/B,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAEnE,eAAO,MAAM,qBAAqB;;;EAGhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAA;AAErE,eAAO,MAAM,sBAAsB,uBAAiB,CAAA;AAEpD,MAAM,MAAM,sBAAsB,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAA"}

package/dist/schemas/flags-admin.js

@@ -0,0 +1,84 @@
+/**
+ * Flags Admin — schemas for Console-plane feature-flag management.
+ * Mirrors `routes/flags.ts`.
+ *
+ * Plane: `management`. Distinct from BaaS `flagsEndpoints` (server-side
+ * evaluation served by the standalone runtime).
+ *
+ * Response shapes use `Schema.Unknown` for large, storage-shape fields
+ * (flag records with nested targeting rules, env-scoped overrides) — the
+ * handler-side types remain the authoritative shape. Following the
+ * newsletter `StepConfig: Schema.Unknown` precedent established in Wave 3C.
+ */
+import { Schema } from 'effect';
+export const FlagsProjectIdParams = Schema.Struct({ id: Schema.String });
+export const FlagsPaginationQuery = Schema.Struct({
+    projectId: Schema.String,
+    environmentId: Schema.optional(Schema.String),
+    limit: Schema.optional(Schema.String),
+    offset: Schema.optional(Schema.String),
+    search: Schema.optional(Schema.String),
+});
+// Flag records carry nested rules / metadata that differ per schema
+// version; surface as Unknown so stored records round-trip intact.
+export const FlagsFeatureFlag = Schema.Unknown;
+/** Alias for consumers migrating from api-types/schemas — stays opaque. */
+export const FeatureFlag = FlagsFeatureFlag;
+export const SerializedFlag = FlagsFeatureFlag;
+export const ListFeatureFlagsResult = Schema.Struct({
+    flags: Schema.Array(FlagsFeatureFlag),
+    total: Schema.Number,
+});
+export const CreateFeatureFlagInput = Schema.Struct({
+    projectId: Schema.String,
+    key: Schema.String,
+    name: Schema.String,
+    description: Schema.optional(Schema.String),
+    enabled: Schema.optional(Schema.Boolean),
+    rolloutPercentage: Schema.optional(Schema.Number),
+    targetPremiumOnly: Schema.optional(Schema.Boolean),
+    targetAdminOnly: Schema.optional(Schema.Boolean),
+    environmentId: Schema.optional(Schema.NullOr(Schema.String)),
+    sortOrder: Schema.optional(Schema.Number),
+});
+export const CreateFeatureFlagResult = FlagsFeatureFlag;
+export const UpdateFeatureFlagInput = Schema.Struct({
+    projectId: Schema.String,
+    id: Schema.String,
+    name: Schema.optional(Schema.String),
+    description: Schema.optional(Schema.NullOr(Schema.String)),
+    enabled: Schema.optional(Schema.Boolean),
+    rolloutPercentage: Schema.optional(Schema.Number),
+    targetPremiumOnly: Schema.optional(Schema.Boolean),
+    targetAdminOnly: Schema.optional(Schema.Boolean),
+    expectedVersion: Schema.optional(Schema.String),
+});
+export const UpdateFeatureFlagResult = FlagsFeatureFlag;
+export const DeleteFeatureFlagInput = Schema.Struct({
+    projectId: Schema.String,
+    id: Schema.String,
+});
+export const DeleteFeatureFlagResult = Schema.Struct({ success: Schema.Boolean });
+export const ReorderFlagsInput = Schema.Struct({
+    projectId: Schema.String,
+    flagIds: Schema.Array(Schema.String),
+});
+export const ReorderFlagsResult = Schema.Struct({ success: Schema.Boolean });
+export const BulkUpdateEnabledInput = Schema.Struct({
+    projectId: Schema.String,
+    flagIds: Schema.Array(Schema.String),
+    enabled: Schema.Boolean,
+});
+export const BulkUpdateEnabledResult = Schema.Struct({
+    success: Schema.Boolean,
+    updated: Schema.Number,
+});
+export const BulkDeleteFlagsInput = Schema.Struct({
+    projectId: Schema.String,
+    flagIds: Schema.Array(Schema.String),
+});
+export const BulkDeleteFlagsResult = Schema.Struct({
+    success: Schema.Boolean,
+    deleted: Schema.Number,
+});
+export const FlagsServiceDataResult = Schema.Unknown;

package/dist/schemas/flags.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Feature Flags — BaaS plane. Server-side evaluation with targeting context.
+ * Mirrors `@sylphx/sdk` `flags.ts`.
+ */
+import { Schema } from 'effect';
+export declare const FlagKey: Schema.brand<Schema.filter<typeof Schema.String>, "FlagKey">;
+export type FlagKey = typeof FlagKey.Type;
+/** LD / Statsig-style targeting context. */
+export declare const FlagContext: Schema.Struct<{
+    userId: Schema.optional<typeof Schema.String>;
+    anonymousId: Schema.optional<typeof Schema.String>;
+    properties: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+}>;
+export type FlagContext = typeof FlagContext.Type;
+export declare const FlagEvaluation: Schema.Struct<{
+    key: typeof Schema.String;
+    enabled: typeof Schema.Boolean;
+    variant: Schema.optional<typeof Schema.String>;
+    reason: Schema.optional<typeof Schema.String>;
+    payload: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+}>;
+export type FlagEvaluation = typeof FlagEvaluation.Type;
+export declare const EvaluateFlagsInput: Schema.Struct<{
+    context: Schema.optional<Schema.Struct<{
+        userId: Schema.optional<typeof Schema.String>;
+        anonymousId: Schema.optional<typeof Schema.String>;
+        properties: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    }>>;
+    /** Omit to evaluate every flag visible to the caller. */
+    keys: Schema.optional<Schema.Array$<typeof Schema.String>>;
+}>;
+export type EvaluateFlagsInput = typeof EvaluateFlagsInput.Type;
+export declare const EvaluateFlagsResult: Schema.Struct<{
+    data: Schema.Record$<typeof Schema.String, Schema.Struct<{
+        key: typeof Schema.String;
+        enabled: typeof Schema.Boolean;
+        variant: Schema.optional<typeof Schema.String>;
+        reason: Schema.optional<typeof Schema.String>;
+        payload: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    }>>;
+}>;
+export type EvaluateFlagsResult = typeof EvaluateFlagsResult.Type;
+//# sourceMappingURL=flags.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/schemas/flags.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,eAAO,MAAM,OAAO,8DAAmE,CAAA;AACvF,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAA;AAEzC,4CAA4C;AAC5C,eAAO,MAAM,WAAW;;;;EAItB,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AAEjD,eAAO,MAAM,cAAc;;;;;;EAMzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD,eAAO,MAAM,kBAAkB;;;;;;IAE9B,yDAAyD;;EAExD,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAE/D,eAAO,MAAM,mBAAmB;;;;;;;;EAE9B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA"}

package/dist/schemas/flags.js

@@ -0,0 +1,27 @@
+/**
+ * Feature Flags — BaaS plane. Server-side evaluation with targeting context.
+ * Mirrors `@sylphx/sdk` `flags.ts`.
+ */
+import { Schema } from 'effect';
+export const FlagKey = Schema.String.pipe(Schema.minLength(1), Schema.brand('FlagKey'));
+/** LD / Statsig-style targeting context. */
+export const FlagContext = Schema.Struct({
+    userId: Schema.optional(Schema.String),
+    anonymousId: Schema.optional(Schema.String),
+    properties: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
+});
+export const FlagEvaluation = Schema.Struct({
+    key: Schema.String,
+    enabled: Schema.Boolean,
+    variant: Schema.optional(Schema.String),
+    reason: Schema.optional(Schema.String),
+    payload: Schema.optional(Schema.Record({ key: Schema.String, value: Schema.Unknown })),
+});
+export const EvaluateFlagsInput = Schema.Struct({
+    context: Schema.optional(FlagContext),
+    /** Omit to evaluate every flag visible to the caller. */
+    keys: Schema.optional(Schema.Array(Schema.String)),
+});
+export const EvaluateFlagsResult = Schema.Struct({
+    data: Schema.Record({ key: Schema.String, value: FlagEvaluation }),
+});

package/dist/schemas/github.d.ts

@@ -0,0 +1,34 @@
+/**
+ * GitHub — schemas for Console GitHub-repo ↔ environment wiring.
+ * Mirrors `routes/github.ts`.
+ *
+ * Plane: `management`.
+ */
+import { Schema } from 'effect';
+export declare const GithubEnvIdParams: Schema.Struct<{
+    envId: typeof Schema.String;
+}>;
+export type GithubEnvIdParams = typeof GithubEnvIdParams.Type;
+export declare const GithubConnectInput: Schema.Struct<{
+    envId: typeof Schema.String;
+    repoFullName: typeof Schema.String;
+    branch: Schema.optional<typeof Schema.String>;
+}>;
+export type GithubConnectInput = typeof GithubConnectInput.Type;
+export declare const GithubConnectResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+    repoFullName: typeof Schema.String;
+    branch: typeof Schema.String;
+}>;
+export type GithubConnectResult = typeof GithubConnectResult.Type;
+export declare const GithubConnectionStatus: Schema.Struct<{
+    connected: typeof Schema.Boolean;
+    repoFullName: Schema.NullOr<typeof Schema.String>;
+    branch: Schema.NullOr<typeof Schema.String>;
+}>;
+export type GithubConnectionStatus = typeof GithubConnectionStatus.Type;
+export declare const GithubDisconnectResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+}>;
+export type GithubDisconnectResult = typeof GithubDisconnectResult.Type;
+//# sourceMappingURL=github.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/schemas/github.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,eAAO,MAAM,iBAAiB;;EAA0C,CAAA;AACxE,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAE7D,eAAO,MAAM,kBAAkB;;;;EAI7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAE/D,eAAO,MAAM,mBAAmB;;;;EAI9B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAEjE,eAAO,MAAM,sBAAsB;;;;EAIjC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AAEvE,eAAO,MAAM,sBAAsB;;EAA6C,CAAA;AAChF,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA"}

package/dist/schemas/github.js

@@ -0,0 +1,24 @@
+/**
+ * GitHub — schemas for Console GitHub-repo ↔ environment wiring.
+ * Mirrors `routes/github.ts`.
+ *
+ * Plane: `management`.
+ */
+import { Schema } from 'effect';
+export const GithubEnvIdParams = Schema.Struct({ envId: Schema.String });
+export const GithubConnectInput = Schema.Struct({
+    envId: Schema.String,
+    repoFullName: Schema.String,
+    branch: Schema.optional(Schema.String),
+});
+export const GithubConnectResult = Schema.Struct({
+    success: Schema.Boolean,
+    repoFullName: Schema.String,
+    branch: Schema.String,
+});
+export const GithubConnectionStatus = Schema.Struct({
+    connected: Schema.Boolean,
+    repoFullName: Schema.NullOr(Schema.String),
+    branch: Schema.NullOr(Schema.String),
+});
+export const GithubDisconnectResult = Schema.Struct({ success: Schema.Boolean });

package/dist/schemas/ids.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Branded identifier schemas — one brand per entity type.
+ *
+ * Values are TypeIDs per ADR-055 (`org_xxx`, `proj_xxx`, …). We keep the
+ * runtime validation deliberately permissive (non-empty string) and rely on
+ * the branding to prevent cross-entity ID mixing at the type level. Stricter
+ * prefix validation lives in `src/lib/ids.ts` of the core package — that is
+ * enforced at the API boundary via `parseIdOrError()`. Consumers of this
+ * package (SDKs, MCP tools) should never cast raw strings to branded IDs;
+ * they get them exclusively from decoded server responses.
+ */
+import { Schema } from 'effect';
+export declare const OrgId: Schema.brand<Schema.filter<typeof Schema.String>, "OrgId">;
+export type OrgId = typeof OrgId.Type;
+export declare const ProjectId: Schema.brand<Schema.filter<typeof Schema.String>, "ProjectId">;
+export type ProjectId = typeof ProjectId.Type;
+export declare const EnvironmentId: Schema.brand<Schema.filter<typeof Schema.String>, "EnvironmentId">;
+export type EnvironmentId = typeof EnvironmentId.Type;
+export declare const ServiceId: Schema.brand<Schema.filter<typeof Schema.String>, "ServiceId">;
+export type ServiceId = typeof ServiceId.Type;
+export declare const UserId: Schema.brand<Schema.filter<typeof Schema.String>, "UserId">;
+export type UserId = typeof UserId.Type;
+export declare const SessionId: Schema.brand<Schema.filter<typeof Schema.String>, "SessionId">;
+export type SessionId = typeof SessionId.Type;
+export declare const DeploymentId: Schema.brand<Schema.filter<typeof Schema.String>, "DeploymentId">;
+export type DeploymentId = typeof DeploymentId.Type;
+export declare const DomainId: Schema.brand<Schema.filter<typeof Schema.String>, "DomainId">;
+export type DomainId = typeof DomainId.Type;
+export declare const HostnameId: Schema.brand<Schema.filter<typeof Schema.String>, "HostnameId">;
+export type HostnameId = typeof HostnameId.Type;
+export declare const SecretId: Schema.brand<Schema.filter<typeof Schema.String>, "SecretId">;
+export type SecretId = typeof SecretId.Type;
+export declare const DatabaseId: Schema.brand<Schema.filter<typeof Schema.String>, "DatabaseId">;
+export type DatabaseId = typeof DatabaseId.Type;
+export declare const ResourceId: Schema.brand<Schema.filter<typeof Schema.String>, "ResourceId">;
+export type ResourceId = typeof ResourceId.Type;
+export declare const InvitationId: Schema.brand<Schema.filter<typeof Schema.String>, "InvitationId">;
+export type InvitationId = typeof InvitationId.Type;
+//# sourceMappingURL=ids.d.ts.map

package/dist/schemas/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/schemas/ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAK/B,eAAO,MAAM,KAAK,4DAAqB,CAAA;AACvC,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAA;AAErC,eAAO,MAAM,SAAS,gEAAyB,CAAA;AAC/C,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAE7C,eAAO,MAAM,aAAa,oEAA6B,CAAA;AACvD,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAErD,eAAO,MAAM,SAAS,gEAAyB,CAAA;AAC/C,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAE7C,eAAO,MAAM,MAAM,6DAAsB,CAAA;AACzC,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,IAAI,CAAA;AAEvC,eAAO,MAAM,SAAS,gEAAyB,CAAA;AAC/C,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAE7C,eAAO,MAAM,YAAY,mEAA4B,CAAA;AACrD,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAEnD,eAAO,MAAM,QAAQ,+DAAwB,CAAA;AAC7C,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAE3C,eAAO,MAAM,UAAU,iEAA0B,CAAA;AACjD,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C,eAAO,MAAM,QAAQ,+DAAwB,CAAA;AAC7C,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAE3C,eAAO,MAAM,UAAU,iEAA0B,CAAA;AACjD,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C,eAAO,MAAM,UAAU,iEAA0B,CAAA;AACjD,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C,eAAO,MAAM,YAAY,mEAA4B,CAAA;AACrD,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA"}

package/dist/schemas/ids.js

@@ -0,0 +1,26 @@
+/**
+ * Branded identifier schemas — one brand per entity type.
+ *
+ * Values are TypeIDs per ADR-055 (`org_xxx`, `proj_xxx`, …). We keep the
+ * runtime validation deliberately permissive (non-empty string) and rely on
+ * the branding to prevent cross-entity ID mixing at the type level. Stricter
+ * prefix validation lives in `src/lib/ids.ts` of the core package — that is
+ * enforced at the API boundary via `parseIdOrError()`. Consumers of this
+ * package (SDKs, MCP tools) should never cast raw strings to branded IDs;
+ * they get them exclusively from decoded server responses.
+ */
+import { Schema } from 'effect';
+const brandedId = (brand) => Schema.String.pipe(Schema.minLength(1), Schema.brand(brand));
+export const OrgId = brandedId('OrgId');
+export const ProjectId = brandedId('ProjectId');
+export const EnvironmentId = brandedId('EnvironmentId');
+export const ServiceId = brandedId('ServiceId');
+export const UserId = brandedId('UserId');
+export const SessionId = brandedId('SessionId');
+export const DeploymentId = brandedId('DeploymentId');
+export const DomainId = brandedId('DomainId');
+export const HostnameId = brandedId('HostnameId');
+export const SecretId = brandedId('SecretId');
+export const DatabaseId = brandedId('DatabaseId');
+export const ResourceId = brandedId('ResourceId');
+export const InvitationId = brandedId('InvitationId');

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

@@ -0,0 +1,70 @@
+/**
+ * Image Optimisation — `img.sylphx.app` signed-URL contract.
+ *
+ * Part of the P1 gap #3 design (`docs/design/edge-functions-isr-image-opt.md`
+ * § 3.3). Customers use the loader shipped in `@sylphx/sdk/nextjs` — it calls
+ * the sign endpoint (or mints URLs client-side when a public bucket is used)
+ * and produces an imgproxy-compatible URL:
+ *
+ *   https://img.sylphx.app/{projectSlug}/{signature}/{params}/{sourcePath}
+ *
+ * Where `{signature}` is HMAC-SHA256 of `{params}/{sourcePath}` with the
+ * project's image-signing secret. The secret NEVER leaves the server —
+ * the signing call is Management plane.
+ *
+ * Scope for the scaffold: sign-only. Imgproxy is still a separate infra PR.
+ * Until that lands, the handler returns a stub signed URL so downstream
+ * consumers can wire the loader without waiting on imgproxy.
+ */
+import { Schema } from 'effect';
+/** Output format. `auto` negotiates via Accept header; the others are forced. */
+export declare const ImageFormat: Schema.Literal<["auto", "avif", "webp", "jpeg", "png"]>;
+export type ImageFormat = typeof ImageFormat.Type;
+/** Resize strategy — mirrors imgproxy's `rt` param. */
+export declare const ImageResizeMode: Schema.Literal<["fit", "fill", "crop", "auto"]>;
+export type ImageResizeMode = typeof ImageResizeMode.Type;
+/**
+ * Input to the signing endpoint. `sourcePath` is an S3 key relative to the
+ * project's storage bucket (e.g. `uploads/hero.png`); `width` / `height`
+ * / `format` map 1:1 to imgproxy params.
+ */
+export declare const ImageOptimizationRequest: 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 multiplier. 1 = 1x, 2 = retina. Capped at 3 server-side. */
+    dpr: Schema.optional<typeof Schema.Number>;
+    /** JPEG / WebP quality (1-100). Default chosen by imgproxy when omitted. */
+    quality: Schema.optional<typeof Schema.Number>;
+}>;
+export type ImageOptimizationRequest = typeof ImageOptimizationRequest.Type;
+/** Signed URL reply. Omits the secret; `signature` is the HMAC truncation. */
+export declare const ImageOptimizationResult: Schema.Struct<{
+    /** Fully-qualified signed URL ready to feed into `<img src>`. */
+    url: typeof Schema.String;
+    /** The signature segment — useful for clients that want to cache the URL shape. */
+    signature: typeof Schema.String;
+    /** The imgproxy preset path used (e.g. `rs:fit:800:600:0/f:webp`). */
+    params: typeof Schema.String;
+    /** Seconds until the signed URL expires. Null when signing is eternal. */
+    expiresIn: Schema.NullOr<typeof Schema.Number>;
+}>;
+export type ImageOptimizationResult = typeof ImageOptimizationResult.Type;
+/**
+ * Path params on the public forwarding route
+ * `GET /img/:signature/:params/:url`.
+ *
+ * The URL segment is the rest of the path after the two sentinel segments.
+ * Hono 1.x does not expose native catch-all param capture in the type, so the
+ * handler reads `c.req.path` to pick up the remainder; `url` here only binds
+ * the first segment for the validator.
+ */
+export declare const ImageForwardParams: Schema.Struct<{
+    signature: typeof Schema.String;
+    params: typeof Schema.String;
+    url: typeof Schema.String;
+}>;
+export type ImageForwardParams = typeof ImageForwardParams.Type;
+//# sourceMappingURL=image-opt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image-opt.d.ts","sourceRoot":"","sources":["../../src/schemas/image-opt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAI/B,iFAAiF;AACjF,eAAO,MAAM,WAAW,yDAAwD,CAAA;AAChF,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AAEjD,uDAAuD;AACvD,eAAO,MAAM,eAAe,iDAAgD,CAAA;AAC5E,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAIzD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;IAMpC,mEAAmE;;IAEnE,4EAA4E;;EAE3E,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAA;AAI3E,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB;IACnC,iEAAiE;;IAEjE,mFAAmF;;IAEnF,sEAAsE;;IAEtE,0EAA0E;;EAEzE,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA;AAIzE;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;EAI7B,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA"}