@sylphx/contract 0.4.0 → 0.5.1

package/dist/schemas/kv.js

@@ -1,7 +1,7 @@
 /**
  * KV — BaaS plane primitives. Mirrors `@sylphx/sdk` `kv.ts` public surface.
  *
- * Paths upstream: `/sdk/kv/*` on `<your-app>.api.sylphx.com`.
+ * Paths upstream: `/kv/*` on `<your-app>.api.sylphx.com`.
  */
 import { Schema } from 'effect';
 /** Opaque per-app key. Namespaced server-side, so any non-empty string is legal. */
@@ -13,13 +13,25 @@ export const KvSetInput = Schema.Struct({
     value: KvValue,
     /** Expire in N seconds. */
     ex: Schema.optional(Schema.Number),
+    /** Expire in N milliseconds. */
+    px: Schema.optional(Schema.Number),
+    /** Unix timestamp (seconds) at which the key will expire. */
+    exat: Schema.optional(Schema.Number),
+    /** Unix timestamp (milliseconds) at which the key will expire. */
+    pxat: Schema.optional(Schema.Number),
     /** Only set if the key does not exist. */
     nx: Schema.optional(Schema.Boolean),
     /** Only set if the key exists. */
     xx: Schema.optional(Schema.Boolean),
 });
-export const KvSetResult = Schema.Struct({ ok: Schema.Boolean });
-export const KvGetResult = Schema.Struct({ value: Schema.NullOr(KvValue) });
+export const KvSetResult = Schema.Struct({
+    success: Schema.Boolean,
+    created: Schema.optional(Schema.Boolean),
+});
+export const KvGetResult = Schema.Struct({
+    value: Schema.NullOr(KvValue),
+    ttl: Schema.NullOr(Schema.Number),
+});
 export const KvDeleteResult = Schema.Struct({ deleted: Schema.Number });
 export const KvExistsResult = Schema.Struct({ exists: Schema.Boolean });
 export const KvIncrInput = Schema.Struct({
@@ -32,9 +44,9 @@ export const KvExpireInput = Schema.Struct({
     seconds: Schema.Number,
 });
 export const KvRateLimitInput = Schema.Struct({
-    identifier: Schema.String,
+    key: Schema.String,
     limit: Schema.Number,
-    window: Schema.Number,
+    window: Schema.String,
 });
 export const KvRateLimitResult = Schema.Struct({
     success: Schema.Boolean,

package/dist/schemas/notifications.d.ts

@@ -53,6 +53,7 @@ export type UnregisterPushResult = typeof UnregisterPushResult.Type;
  *
  * Superset of two historical shapes (ADR-084 Wave 2d):
  *
+ * - Runtime aggregate: `{ sent, failed, platforms }`
  * - SDK-historical counter: `{ sentTo: number, expired: number }`
  * - Contract-v1 discriminated union: `{ status: 'delivered'|'queued',
  *   messageId } | { status: 'failed', reason }`
@@ -69,6 +70,16 @@ export declare const PushDeliveryResult: Schema.Struct<{
     messageId: Schema.optional<typeof Schema.String>;
     /** Human-readable failure reason — present on `failed`. */
     reason: Schema.optional<typeof Schema.String>;
+    /** Canonical aggregate delivery count from the runtime API. */
+    sent: Schema.optional<typeof Schema.Number>;
+    /** Canonical aggregate failure count from the runtime API. */
+    failed: Schema.optional<typeof Schema.Number>;
+    /** Canonical per-platform success breakdown from the runtime API. */
+    platforms: Schema.optional<Schema.Struct<{
+        web: Schema.optional<typeof Schema.Number>;
+        ios: Schema.optional<typeof Schema.Number>;
+        android: Schema.optional<typeof Schema.Number>;
+    }>>;
     /** Count of subscriptions the push was delivered to (SDK counter). */
     sentTo: Schema.optional<typeof Schema.Number>;
     /** Count of subscriptions that were pruned as expired (SDK counter). */

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

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

package/dist/schemas/notifications.js

@@ -38,6 +38,7 @@ export const UnregisterPushResult = Schema.Struct({
  *
  * Superset of two historical shapes (ADR-084 Wave 2d):
  *
+ * - Runtime aggregate: `{ sent, failed, platforms }`
  * - SDK-historical counter: `{ sentTo: number, expired: number }`
  * - Contract-v1 discriminated union: `{ status: 'delivered'|'queued',
  *   messageId } | { status: 'failed', reason }`
@@ -54,6 +55,16 @@ export const PushDeliveryResult = Schema.Struct({
     messageId: Schema.optional(Schema.String),
     /** Human-readable failure reason — present on `failed`. */
     reason: Schema.optional(Schema.String),
+    /** Canonical aggregate delivery count from the runtime API. */
+    sent: Schema.optional(Schema.Number),
+    /** Canonical aggregate failure count from the runtime API. */
+    failed: Schema.optional(Schema.Number),
+    /** Canonical per-platform success breakdown from the runtime API. */
+    platforms: Schema.optional(Schema.Struct({
+        web: Schema.optional(Schema.Number),
+        ios: Schema.optional(Schema.Number),
+        android: Schema.optional(Schema.Number),
+    })),
     /** Count of subscriptions the push was delivered to (SDK counter). */
     sentTo: Schema.optional(Schema.Number),
     /** Count of subscriptions that were pruned as expired (SDK counter). */