@sylphx/contract 0.2.0

package/dist/schemas/ai.d.ts

@@ -0,0 +1,120 @@
+/**
+ * AI — BaaS plane schemas for model listing, usage analytics, and rate
+ * limits. Mirrors the runtime API at `GET /ai/models`, `/ai/usage`,
+ * `/ai/rate-limit` (see `apps/runtime/src/server/runtime/schemas/ai.ts`).
+ *
+ * Chat-completion and embedding envelopes aren't included here — the SDK
+ * keeps local OpenAI-compatible shapes for those since they pass through
+ * the Vercel AI SDK bridge and change independently of the platform
+ * contract. Consumers that need the envelope shape should import it
+ * directly from `@sylphx/sdk`.
+ */
+import { Schema } from 'effect';
+/** Time period for usage statistics. */
+export declare const AIUsagePeriod: Schema.Literal<["day", "week", "month"]>;
+export type AIUsagePeriod = typeof AIUsagePeriod.Type;
+/** Capability buckets a model may advertise. */
+export declare const AIModelCapability: Schema.Literal<["chat", "vision", "tool", "embedding"]>;
+export type AIModelCapability = typeof AIModelCapability.Type;
+/** Single model row returned by `GET /ai/models`. */
+export declare const AIModel: Schema.Struct<{
+    id: typeof Schema.String;
+    name: typeof Schema.String;
+    contextWindow: typeof Schema.Number;
+    capabilities: Schema.Array$<Schema.Literal<["chat", "vision", "tool", "embedding"]>>;
+    inputCostPer1M: typeof Schema.Number;
+    outputCostPer1M: typeof Schema.Number;
+    description: Schema.optional<typeof Schema.String>;
+}>;
+export type AIModel = typeof AIModel.Type;
+/** `GET /ai/models` response — cursor-paginated. */
+export declare const GetModelsResponse: Schema.Struct<{
+    models: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        name: typeof Schema.String;
+        contextWindow: typeof Schema.Number;
+        capabilities: Schema.Array$<Schema.Literal<["chat", "vision", "tool", "embedding"]>>;
+        inputCostPer1M: typeof Schema.Number;
+        outputCostPer1M: typeof Schema.Number;
+        description: Schema.optional<typeof Schema.String>;
+    }>>;
+    nextCursor: Schema.NullOr<typeof Schema.String>;
+    hasMore: typeof Schema.Boolean;
+}>;
+export type GetModelsResponse = typeof GetModelsResponse.Type;
+/** Input/output/total token aggregate. */
+export declare const TokensBreakdown: Schema.Struct<{
+    input: typeof Schema.Number;
+    output: typeof Schema.Number;
+    total: typeof Schema.Number;
+}>;
+export type TokensBreakdown = typeof TokensBreakdown.Type;
+/** Cost aggregate — microdollars stored + human-readable format side-band. */
+export declare const CostBreakdown: Schema.Struct<{
+    microdollars: typeof Schema.Number;
+    formatted: typeof Schema.String;
+}>;
+export type CostBreakdown = typeof CostBreakdown.Type;
+/** Per-model usage row inside `GetUsageResponse.byModel`. */
+export declare const ModelUsage: Schema.Struct<{
+    requests: typeof Schema.Number;
+    tokens: typeof Schema.Number;
+    cost: typeof Schema.Number;
+}>;
+export type ModelUsage = typeof ModelUsage.Type;
+/** Per-request-type usage row inside `GetUsageResponse.byType`. */
+export declare const TypeUsage: Schema.Struct<{
+    requests: typeof Schema.Number;
+    tokens: typeof Schema.Number;
+}>;
+export type TypeUsage = typeof TypeUsage.Type;
+/** `GET /ai/usage` response. */
+export declare const GetUsageResponse: Schema.Struct<{
+    period: Schema.Literal<["day", "week", "month"]>;
+    requests: typeof Schema.Number;
+    tokens: Schema.Struct<{
+        input: typeof Schema.Number;
+        output: typeof Schema.Number;
+        total: typeof Schema.Number;
+    }>;
+    cost: Schema.Struct<{
+        microdollars: typeof Schema.Number;
+        formatted: typeof Schema.String;
+    }>;
+    byModel: Schema.Record$<typeof Schema.String, Schema.Struct<{
+        requests: typeof Schema.Number;
+        tokens: typeof Schema.Number;
+        cost: typeof Schema.Number;
+    }>>;
+    byType: Schema.Record$<typeof Schema.String, Schema.Struct<{
+        requests: typeof Schema.Number;
+        tokens: typeof Schema.Number;
+    }>>;
+}>;
+export type GetUsageResponse = typeof GetUsageResponse.Type;
+/** Current-window usage counters reported alongside configured caps. */
+export declare const CurrentRateLimitUsage: Schema.Struct<{
+    requestsThisMinute: typeof Schema.Number;
+    requestsToday: typeof Schema.Number;
+    tokensThisMinute: typeof Schema.Number;
+    tokensToday: typeof Schema.Number;
+    costToday: typeof Schema.Number;
+}>;
+export type CurrentRateLimitUsage = typeof CurrentRateLimitUsage.Type;
+/** `GET /ai/rate-limit` response — null ceilings mean "unlimited". */
+export declare const GetRateLimitResponse: Schema.Struct<{
+    requestsPerMinute: Schema.NullOr<typeof Schema.Number>;
+    requestsPerDay: Schema.NullOr<typeof Schema.Number>;
+    tokensPerMinute: Schema.NullOr<typeof Schema.Number>;
+    tokensPerDay: Schema.NullOr<typeof Schema.Number>;
+    costPerDayMicrodollars: Schema.NullOr<typeof Schema.Number>;
+    current: Schema.Struct<{
+        requestsThisMinute: typeof Schema.Number;
+        requestsToday: typeof Schema.Number;
+        tokensThisMinute: typeof Schema.Number;
+        tokensToday: typeof Schema.Number;
+        costToday: typeof Schema.Number;
+    }>;
+}>;
+export type GetRateLimitResponse = typeof GetRateLimitResponse.Type;
+//# sourceMappingURL=ai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/schemas/ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAI/B,wCAAwC;AACxC,eAAO,MAAM,aAAa,0CAAyC,CAAA;AACnE,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAErD,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,yDAAwD,CAAA;AACtF,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAI7D,qDAAqD;AACrD,eAAO,MAAM,OAAO;;;;;;;;EAQlB,CAAA;AACF,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAA;AAEzC,oDAAoD;AACpD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAI7D,0CAA0C;AAC1C,eAAO,MAAM,eAAe;;;;EAI1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD,8EAA8E;AAC9E,eAAO,MAAM,aAAa;;;EAGxB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAErD,6DAA6D;AAC7D,eAAO,MAAM,UAAU;;;;EAIrB,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C,mEAAmE;AACnE,eAAO,MAAM,SAAS;;;EAGpB,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAE7C,gCAAgC;AAChC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAO3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;AAI3D,wEAAwE;AACxE,eAAO,MAAM,qBAAqB;;;;;;EAMhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC,IAAI,CAAA;AAErE,sEAAsE;AACtE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;EAO/B,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA"}

package/dist/schemas/ai.js

@@ -0,0 +1,84 @@
+/**
+ * AI — BaaS plane schemas for model listing, usage analytics, and rate
+ * limits. Mirrors the runtime API at `GET /ai/models`, `/ai/usage`,
+ * `/ai/rate-limit` (see `apps/runtime/src/server/runtime/schemas/ai.ts`).
+ *
+ * Chat-completion and embedding envelopes aren't included here — the SDK
+ * keeps local OpenAI-compatible shapes for those since they pass through
+ * the Vercel AI SDK bridge and change independently of the platform
+ * contract. Consumers that need the envelope shape should import it
+ * directly from `@sylphx/sdk`.
+ */
+import { Schema } from 'effect';
+// ── Shared enums ───────────────────────────────────────────────────────────
+/** Time period for usage statistics. */
+export const AIUsagePeriod = Schema.Literal('day', 'week', 'month');
+/** Capability buckets a model may advertise. */
+export const AIModelCapability = Schema.Literal('chat', 'vision', 'tool', 'embedding');
+// ── Models ─────────────────────────────────────────────────────────────────
+/** Single model row returned by `GET /ai/models`. */
+export const AIModel = Schema.Struct({
+    id: Schema.String,
+    name: Schema.String,
+    contextWindow: Schema.Number,
+    capabilities: Schema.Array(AIModelCapability),
+    inputCostPer1M: Schema.Number,
+    outputCostPer1M: Schema.Number,
+    description: Schema.optional(Schema.String),
+});
+/** `GET /ai/models` response — cursor-paginated. */
+export const GetModelsResponse = Schema.Struct({
+    models: Schema.Array(AIModel),
+    nextCursor: Schema.NullOr(Schema.String),
+    hasMore: Schema.Boolean,
+});
+// ── Usage ──────────────────────────────────────────────────────────────────
+/** Input/output/total token aggregate. */
+export const TokensBreakdown = Schema.Struct({
+    input: Schema.Number,
+    output: Schema.Number,
+    total: Schema.Number,
+});
+/** Cost aggregate — microdollars stored + human-readable format side-band. */
+export const CostBreakdown = Schema.Struct({
+    microdollars: Schema.Number,
+    formatted: Schema.String,
+});
+/** Per-model usage row inside `GetUsageResponse.byModel`. */
+export const ModelUsage = Schema.Struct({
+    requests: Schema.Number,
+    tokens: Schema.Number,
+    cost: Schema.Number,
+});
+/** Per-request-type usage row inside `GetUsageResponse.byType`. */
+export const TypeUsage = Schema.Struct({
+    requests: Schema.Number,
+    tokens: Schema.Number,
+});
+/** `GET /ai/usage` response. */
+export const GetUsageResponse = Schema.Struct({
+    period: AIUsagePeriod,
+    requests: Schema.Number,
+    tokens: TokensBreakdown,
+    cost: CostBreakdown,
+    byModel: Schema.Record({ key: Schema.String, value: ModelUsage }),
+    byType: Schema.Record({ key: Schema.String, value: TypeUsage }),
+});
+// ── Rate limits ────────────────────────────────────────────────────────────
+/** Current-window usage counters reported alongside configured caps. */
+export const CurrentRateLimitUsage = Schema.Struct({
+    requestsThisMinute: Schema.Number,
+    requestsToday: Schema.Number,
+    tokensThisMinute: Schema.Number,
+    tokensToday: Schema.Number,
+    costToday: Schema.Number,
+});
+/** `GET /ai/rate-limit` response — null ceilings mean "unlimited". */
+export const GetRateLimitResponse = Schema.Struct({
+    requestsPerMinute: Schema.NullOr(Schema.Number),
+    requestsPerDay: Schema.NullOr(Schema.Number),
+    tokensPerMinute: Schema.NullOr(Schema.Number),
+    tokensPerDay: Schema.NullOr(Schema.Number),
+    costPerDayMicrodollars: Schema.NullOr(Schema.Number),
+    current: CurrentRateLimitUsage,
+});

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

@@ -0,0 +1,104 @@
+/**
+ * Analytics Admin — schemas for Console-plane analytics dashboard.
+ * Mirrors `routes/analytics/**`.
+ *
+ * Plane: `management`. `-admin` distinguishes from BaaS `analyticsEndpoints`
+ * (track/identify/page/batch served by the standalone runtime).
+ *
+ * Response shapes use `Schema.Unknown` for the aggregate dashboards
+ * (stats/funnel/top-queries/destinations logs) — they're computed
+ * breakdowns that evolve over time (newsletter `StepConfig` precedent).
+ */
+import { Schema } from 'effect';
+export declare const AnalyticsProjectIdParams: Schema.Struct<{
+    id: typeof Schema.String;
+}>;
+export type AnalyticsProjectIdParams = typeof AnalyticsProjectIdParams.Type;
+export declare const AnalyticsProjectSlugParams: Schema.Struct<{
+    projectId: typeof Schema.String;
+}>;
+export type AnalyticsProjectSlugParams = typeof AnalyticsProjectSlugParams.Type;
+export declare const AnalyticsCohortIdParams: Schema.Struct<{
+    cohortId: typeof Schema.String;
+}>;
+export type AnalyticsCohortIdParams = typeof AnalyticsCohortIdParams.Type;
+export declare const AnalyticsProjectCohortIdParams: Schema.Struct<{
+    projectId: typeof Schema.String;
+    cohortId: typeof Schema.String;
+}>;
+export type AnalyticsProjectCohortIdParams = typeof AnalyticsProjectCohortIdParams.Type;
+export declare const AnalyticsDestinationIdParams: Schema.Struct<{
+    projectId: typeof Schema.String;
+    destinationId: typeof Schema.String;
+}>;
+export type AnalyticsDestinationIdParams = typeof AnalyticsDestinationIdParams.Type;
+export declare const AnalyticsDestinationLogIdParams: Schema.Struct<{
+    projectId: typeof Schema.String;
+    destinationId: typeof Schema.String;
+    logId: typeof Schema.String;
+}>;
+export type AnalyticsDestinationLogIdParams = typeof AnalyticsDestinationLogIdParams.Type;
+export declare const AnalyticsRangeQuery: Schema.Struct<{
+    period: Schema.optional<typeof Schema.String>;
+    dateFrom: Schema.optional<typeof Schema.String>;
+    dateTo: Schema.optional<typeof Schema.String>;
+    limit: Schema.optional<typeof Schema.String>;
+    offset: Schema.optional<typeof Schema.String>;
+    interval: Schema.optional<typeof Schema.String>;
+    event: Schema.optional<typeof Schema.String>;
+    page: Schema.optional<typeof Schema.String>;
+    search: Schema.optional<typeof Schema.String>;
+    userId: Schema.optional<typeof Schema.String>;
+    status: Schema.optional<typeof Schema.String>;
+}>;
+export type AnalyticsRangeQuery = typeof AnalyticsRangeQuery.Type;
+export declare const AnalyticsEmptyQuery: Schema.Struct<{}>;
+export type AnalyticsEmptyQuery = typeof AnalyticsEmptyQuery.Type;
+export declare const AnalyticsDashboardResult: typeof Schema.Unknown;
+export type AnalyticsDashboardResult = typeof AnalyticsDashboardResult.Type;
+export declare const AnalyticsGenericInput: typeof Schema.Unknown;
+export type AnalyticsGenericInput = typeof AnalyticsGenericInput.Type;
+export declare const AnalyticsGenericResult: typeof Schema.Unknown;
+export type AnalyticsGenericResult = typeof AnalyticsGenericResult.Type;
+export declare const CreateAnalyticsDestinationInput: typeof Schema.Unknown;
+export type CreateAnalyticsDestinationInput = typeof CreateAnalyticsDestinationInput.Type;
+export declare const UpdateAnalyticsDestinationInput: typeof Schema.Unknown;
+export type UpdateAnalyticsDestinationInput = typeof UpdateAnalyticsDestinationInput.Type;
+export declare const TestAnalyticsDestinationInput: typeof Schema.Unknown;
+export type TestAnalyticsDestinationInput = typeof TestAnalyticsDestinationInput.Type;
+export declare const BulkRetryAnalyticsLogsInput: typeof Schema.Unknown;
+export type BulkRetryAnalyticsLogsInput = typeof BulkRetryAnalyticsLogsInput.Type;
+export declare const CreateCohortInput: typeof Schema.Unknown;
+export type CreateCohortInput = typeof CreateCohortInput.Type;
+export declare const UpdateCohortInput: typeof Schema.Unknown;
+export type UpdateCohortInput = typeof UpdateCohortInput.Type;
+export declare const AddCohortMembersInput: typeof Schema.Unknown;
+export type AddCohortMembersInput = typeof AddCohortMembersInput.Type;
+export declare const RemoveCohortMembersInput: typeof Schema.Unknown;
+export type RemoveCohortMembersInput = typeof RemoveCohortMembersInput.Type;
+type AnalyticsOpenRecord = {
+    [k: string]: any;
+};
+export type AnalyticsStatsResult = AnalyticsOpenRecord;
+export type EventsListResult = AnalyticsOpenRecord;
+export type ApiUsageResult = AnalyticsOpenRecord;
+export type ApiUsageHistoryResult = AnalyticsOpenRecord;
+export type AnalyticsDestination = AnalyticsOpenRecord;
+export type DestinationsListResult = AnalyticsOpenRecord;
+export type CreateDestinationResult = AnalyticsOpenRecord;
+export type TestDestinationResult = AnalyticsOpenRecord;
+export type Cohort = AnalyticsOpenRecord;
+export type CohortDetail = AnalyticsOpenRecord;
+export type CohortsListResult = AnalyticsOpenRecord;
+export type CreateCohortResult = AnalyticsOpenRecord;
+export type ExportJsonResult = AnalyticsOpenRecord;
+export type ExportCsvResult = AnalyticsOpenRecord;
+export type AnalyticsSuccessResult = AnalyticsOpenRecord;
+/** Analytics stats period. */
+export declare const AnalyticsPeriod: Schema.Literal<["day", "week", "month"]>;
+export type AnalyticsPeriod = typeof AnalyticsPeriod.Type;
+/** Analytics service name passed as query param to scope stats endpoints. */
+export declare const AnalyticsService: Schema.Literal<["users", "events", "pages", "api", "destinations", "cohorts", "custom"]>;
+export type AnalyticsService = typeof AnalyticsService.Type;
+export {};
+//# sourceMappingURL=analytics-admin.d.ts.map

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

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

package/dist/schemas/analytics-admin.js

@@ -0,0 +1,61 @@
+/**
+ * Analytics Admin — schemas for Console-plane analytics dashboard.
+ * Mirrors `routes/analytics/**`.
+ *
+ * Plane: `management`. `-admin` distinguishes from BaaS `analyticsEndpoints`
+ * (track/identify/page/batch served by the standalone runtime).
+ *
+ * Response shapes use `Schema.Unknown` for the aggregate dashboards
+ * (stats/funnel/top-queries/destinations logs) — they're computed
+ * breakdowns that evolve over time (newsletter `StepConfig` precedent).
+ */
+import { Schema } from 'effect';
+export const AnalyticsProjectIdParams = Schema.Struct({ id: Schema.String });
+export const AnalyticsProjectSlugParams = Schema.Struct({ projectId: Schema.String });
+export const AnalyticsCohortIdParams = Schema.Struct({ cohortId: Schema.String });
+export const AnalyticsProjectCohortIdParams = Schema.Struct({
+    projectId: Schema.String,
+    cohortId: Schema.String,
+});
+export const AnalyticsDestinationIdParams = Schema.Struct({
+    projectId: Schema.String,
+    destinationId: Schema.String,
+});
+export const AnalyticsDestinationLogIdParams = Schema.Struct({
+    projectId: Schema.String,
+    destinationId: Schema.String,
+    logId: Schema.String,
+});
+// ── Generic paginate / filter queries ─────────────────────────────────────
+export const AnalyticsRangeQuery = Schema.Struct({
+    period: Schema.optional(Schema.String),
+    dateFrom: Schema.optional(Schema.String),
+    dateTo: Schema.optional(Schema.String),
+    limit: Schema.optional(Schema.String),
+    offset: Schema.optional(Schema.String),
+    interval: Schema.optional(Schema.String),
+    event: Schema.optional(Schema.String),
+    page: Schema.optional(Schema.String),
+    search: Schema.optional(Schema.String),
+    userId: Schema.optional(Schema.String),
+    status: Schema.optional(Schema.String),
+});
+export const AnalyticsEmptyQuery = Schema.Struct({});
+// ── Generic unknown response (computed aggregates) ────────────────────────
+export const AnalyticsDashboardResult = Schema.Unknown;
+export const AnalyticsGenericInput = Schema.Unknown;
+export const AnalyticsGenericResult = Schema.Unknown;
+// ── Bodies for destinations CRUD + bulk actions ───────────────────────────
+export const CreateAnalyticsDestinationInput = Schema.Unknown;
+export const UpdateAnalyticsDestinationInput = Schema.Unknown;
+export const TestAnalyticsDestinationInput = Schema.Unknown;
+export const BulkRetryAnalyticsLogsInput = Schema.Unknown;
+// ── Cohort bodies ─────────────────────────────────────────────────────────
+export const CreateCohortInput = Schema.Unknown;
+export const UpdateCohortInput = Schema.Unknown;
+export const AddCohortMembersInput = Schema.Unknown;
+export const RemoveCohortMembersInput = Schema.Unknown;
+/** Analytics stats period. */
+export const AnalyticsPeriod = Schema.Literal('day', 'week', 'month');
+/** Analytics service name passed as query param to scope stats endpoints. */
+export const AnalyticsService = Schema.Literal('users', 'events', 'pages', 'api', 'destinations', 'cohorts', 'custom');

package/dist/schemas/analytics.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Analytics — BaaS plane event tracking. Mirrors `@sylphx/sdk/analytics.ts`
+ * (Segment-style `track` / `identify` / `page`) and the runtime routes at
+ * `apps/runtime/src/server/runtime/routes/analytics.ts` (wire truth).
+ *
+ * `TrackEvent` is the full event envelope accepted by the batch endpoint —
+ * it extends `TrackInput` with ad-destination metadata (`destinations`,
+ * `skipDestinations`) and an optional `conversion` payload used by the
+ * destinations worker to forward conversions to Google Ads / Meta / TikTok.
+ */
+import { Schema } from 'effect';
+/** Ad-platform destinations a `TrackEvent` may be forwarded to. */
+export declare const DestinationPlatform: Schema.Literal<["google_ads", "meta", "tiktok"]>;
+export type DestinationPlatform = typeof DestinationPlatform.Type;
+/** Enhanced-conversion payload forwarded to ad platforms. */
+export declare const ConversionData: Schema.Struct<{
+    clickId: Schema.optional<typeof Schema.String>;
+    value: Schema.optional<typeof Schema.Number>;
+    currency: Schema.optional<typeof Schema.String>;
+    orderId: Schema.optional<typeof Schema.String>;
+    userEmail: Schema.optional<typeof Schema.String>;
+    userPhone: Schema.optional<typeof Schema.String>;
+    userFirstName: Schema.optional<typeof Schema.String>;
+    userLastName: Schema.optional<typeof Schema.String>;
+}>;
+export type ConversionData = typeof ConversionData.Type;
+export declare const TrackInput: Schema.Struct<{
+    event: typeof Schema.String;
+    properties: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    userId: Schema.optional<typeof Schema.String>;
+    anonymousId: Schema.optional<typeof Schema.String>;
+    timestamp: Schema.optional<typeof Schema.String>;
+}>;
+export type TrackInput = typeof TrackInput.Type;
+export declare const IdentifyInput: Schema.Struct<{
+    userId: typeof Schema.String;
+    traits: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    anonymousId: Schema.optional<typeof Schema.String>;
+    timestamp: Schema.optional<typeof Schema.String>;
+}>;
+export type IdentifyInput = typeof IdentifyInput.Type;
+export declare const PageInput: Schema.Struct<{
+    name: typeof Schema.String;
+    properties: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    userId: Schema.optional<typeof Schema.String>;
+    anonymousId: Schema.optional<typeof Schema.String>;
+    /**
+     * ISO-8601 timestamp of the page view. Defaults to server receive time
+     * when absent. Kept as `string` (not `DateFromString`) so the contract
+     * stays codec-free on the wire and matches how SDK sends it.
+     */
+    timestamp: Schema.optional<typeof Schema.String>;
+}>;
+export type PageInput = typeof PageInput.Type;
+/**
+ * Full event envelope accepted by the batch endpoint. Superset of
+ * `TrackInput` with optional ad-destination routing metadata. Mirrors
+ * `TrackEventSchema` in `apps/runtime/.../schemas/analytics.ts`.
+ */
+export declare const TrackEvent: Schema.Struct<{
+    event: typeof Schema.String;
+    properties: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+    timestamp: Schema.optional<typeof Schema.String>;
+    destinations: Schema.optional<Schema.Array$<Schema.Literal<["google_ads", "meta", "tiktok"]>>>;
+    skipDestinations: Schema.optional<typeof Schema.Boolean>;
+    conversion: Schema.optional<Schema.Struct<{
+        clickId: Schema.optional<typeof Schema.String>;
+        value: Schema.optional<typeof Schema.Number>;
+        currency: Schema.optional<typeof Schema.String>;
+        orderId: Schema.optional<typeof Schema.String>;
+        userEmail: Schema.optional<typeof Schema.String>;
+        userPhone: Schema.optional<typeof Schema.String>;
+        userFirstName: Schema.optional<typeof Schema.String>;
+        userLastName: Schema.optional<typeof Schema.String>;
+    }>>;
+    userId: Schema.optional<typeof Schema.String>;
+    anonymousId: Schema.optional<typeof Schema.String>;
+}>;
+export type TrackEvent = typeof TrackEvent.Type;
+export declare const BatchTrackInput: Schema.Struct<{
+    events: Schema.Array$<Schema.Struct<{
+        event: typeof Schema.String;
+        properties: Schema.optional<Schema.Record$<typeof Schema.String, typeof Schema.Unknown>>;
+        timestamp: Schema.optional<typeof Schema.String>;
+        destinations: Schema.optional<Schema.Array$<Schema.Literal<["google_ads", "meta", "tiktok"]>>>;
+        skipDestinations: Schema.optional<typeof Schema.Boolean>;
+        conversion: Schema.optional<Schema.Struct<{
+            clickId: Schema.optional<typeof Schema.String>;
+            value: Schema.optional<typeof Schema.Number>;
+            currency: Schema.optional<typeof Schema.String>;
+            orderId: Schema.optional<typeof Schema.String>;
+            userEmail: Schema.optional<typeof Schema.String>;
+            userPhone: Schema.optional<typeof Schema.String>;
+            userFirstName: Schema.optional<typeof Schema.String>;
+            userLastName: Schema.optional<typeof Schema.String>;
+        }>>;
+        userId: Schema.optional<typeof Schema.String>;
+        anonymousId: Schema.optional<typeof Schema.String>;
+    }>>;
+}>;
+export type BatchTrackInput = typeof BatchTrackInput.Type;
+/**
+ * Batch-track response. Shape matches the runtime handler
+ * (`BatchTrackResponseSchema` in `apps/runtime/.../schemas/analytics.ts`):
+ * `success` + per-batch counters for inserted / deduplicated / total.
+ */
+export declare const BatchTrackResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+    count: typeof Schema.Number;
+    deduplicated: typeof Schema.Number;
+    total: typeof Schema.Number;
+}>;
+export type BatchTrackResult = typeof BatchTrackResult.Type;
+export declare const TrackResult: Schema.Struct<{
+    success: typeof Schema.Boolean;
+}>;
+export type TrackResult = typeof TrackResult.Type;
+//# sourceMappingURL=analytics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/schemas/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAI/B,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,kDAAiD,CAAA;AACjF,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAEjE,6DAA6D;AAC7D,eAAO,MAAM,cAAc;;;;;;;;;EASzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD,eAAO,MAAM,UAAU;;;;;;EAMrB,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C,eAAO,MAAM,aAAa;;;;;EAKxB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAErD,eAAO,MAAM,SAAS;;;;;IAKrB;;;;OAIG;;EAEF,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;EASrB,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;EAE1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;EAK3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;AAE3D,eAAO,MAAM,WAAW;;EAA6C,CAAA;AACrE,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA"}

package/dist/schemas/analytics.js

@@ -0,0 +1,80 @@
+/**
+ * Analytics — BaaS plane event tracking. Mirrors `@sylphx/sdk/analytics.ts`
+ * (Segment-style `track` / `identify` / `page`) and the runtime routes at
+ * `apps/runtime/src/server/runtime/routes/analytics.ts` (wire truth).
+ *
+ * `TrackEvent` is the full event envelope accepted by the batch endpoint —
+ * it extends `TrackInput` with ad-destination metadata (`destinations`,
+ * `skipDestinations`) and an optional `conversion` payload used by the
+ * destinations worker to forward conversions to Google Ads / Meta / TikTok.
+ */
+import { Schema } from 'effect';
+const EventProps = Schema.Record({ key: Schema.String, value: Schema.Unknown });
+/** Ad-platform destinations a `TrackEvent` may be forwarded to. */
+export const DestinationPlatform = Schema.Literal('google_ads', 'meta', 'tiktok');
+/** Enhanced-conversion payload forwarded to ad platforms. */
+export const ConversionData = Schema.Struct({
+    clickId: Schema.optional(Schema.String),
+    value: Schema.optional(Schema.Number),
+    currency: Schema.optional(Schema.String),
+    orderId: Schema.optional(Schema.String),
+    userEmail: Schema.optional(Schema.String),
+    userPhone: Schema.optional(Schema.String),
+    userFirstName: Schema.optional(Schema.String),
+    userLastName: Schema.optional(Schema.String),
+});
+export const TrackInput = Schema.Struct({
+    event: Schema.String,
+    properties: Schema.optional(EventProps),
+    userId: Schema.optional(Schema.String),
+    anonymousId: Schema.optional(Schema.String),
+    timestamp: Schema.optional(Schema.String),
+});
+export const IdentifyInput = Schema.Struct({
+    userId: Schema.String,
+    traits: Schema.optional(EventProps),
+    anonymousId: Schema.optional(Schema.String),
+    timestamp: Schema.optional(Schema.String),
+});
+export const PageInput = Schema.Struct({
+    name: Schema.String,
+    properties: Schema.optional(EventProps),
+    userId: Schema.optional(Schema.String),
+    anonymousId: Schema.optional(Schema.String),
+    /**
+     * ISO-8601 timestamp of the page view. Defaults to server receive time
+     * when absent. Kept as `string` (not `DateFromString`) so the contract
+     * stays codec-free on the wire and matches how SDK sends it.
+     */
+    timestamp: Schema.optional(Schema.String),
+});
+/**
+ * Full event envelope accepted by the batch endpoint. Superset of
+ * `TrackInput` with optional ad-destination routing metadata. Mirrors
+ * `TrackEventSchema` in `apps/runtime/.../schemas/analytics.ts`.
+ */
+export const TrackEvent = Schema.Struct({
+    event: Schema.String,
+    properties: Schema.optional(EventProps),
+    timestamp: Schema.optional(Schema.String),
+    destinations: Schema.optional(Schema.Array(DestinationPlatform)),
+    skipDestinations: Schema.optional(Schema.Boolean),
+    conversion: Schema.optional(ConversionData),
+    userId: Schema.optional(Schema.String),
+    anonymousId: Schema.optional(Schema.String),
+});
+export const BatchTrackInput = Schema.Struct({
+    events: Schema.Array(TrackEvent),
+});
+/**
+ * Batch-track response. Shape matches the runtime handler
+ * (`BatchTrackResponseSchema` in `apps/runtime/.../schemas/analytics.ts`):
+ * `success` + per-batch counters for inserted / deduplicated / total.
+ */
+export const BatchTrackResult = Schema.Struct({
+    success: Schema.Boolean,
+    count: Schema.Number,
+    deduplicated: Schema.Number,
+    total: Schema.Number,
+});
+export const TrackResult = Schema.Struct({ success: Schema.Boolean });