@oxy.so/contracts 5.8.0 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (231) hide show
  1. package/dist/cjs/accountAccess.js +6 -5
  2. package/dist/cjs/accountEmail.js +13 -5
  3. package/dist/cjs/accountGraph.js +10 -9
  4. package/dist/cjs/accountName.js +3 -2
  5. package/dist/cjs/agency.js +91 -34
  6. package/dist/cjs/agentKeys.js +21 -17
  7. package/dist/cjs/appAssertions.js +14 -13
  8. package/dist/cjs/applicationRoles.js +19 -12
  9. package/dist/cjs/campaignAttribution.js +28 -0
  10. package/dist/cjs/civic.js +10 -9
  11. package/dist/cjs/client/campaignAttribution.js +14 -0
  12. package/dist/cjs/client/check.js +61 -53
  13. package/dist/cjs/client/index.js +7 -1
  14. package/dist/cjs/client/language.js +7 -0
  15. package/dist/cjs/consoleOnboarding.js +9 -4
  16. package/dist/cjs/contentClaims.js +23 -14
  17. package/dist/cjs/deviceDirectory.js +11 -9
  18. package/dist/cjs/deviceSession.js +27 -25
  19. package/dist/cjs/email/messages.js +20 -18
  20. package/dist/cjs/emailAgentContext.js +11 -9
  21. package/dist/cjs/externalIdentity.js +15 -11
  22. package/dist/cjs/federationInstanceFetch.js +12 -7
  23. package/dist/cjs/identity.js +19 -17
  24. package/dist/cjs/identityLink.js +6 -4
  25. package/dist/cjs/identityProof.js +6 -4
  26. package/dist/cjs/inboxPush.js +5 -4
  27. package/dist/cjs/index.js +17 -6
  28. package/dist/cjs/inference/accountBilling.js +35 -33
  29. package/dist/cjs/inference/aliaModelRelease.js +9 -7
  30. package/dist/cjs/inference/attribution.js +14 -12
  31. package/dist/cjs/inference/catalogue.js +35 -29
  32. package/dist/cjs/inference/economics.js +24 -19
  33. package/dist/cjs/inference/embeddings.js +9 -7
  34. package/dist/cjs/inference/entitlement.js +17 -15
  35. package/dist/cjs/inference/errors.js +15 -8
  36. package/dist/cjs/inference/identifiers.js +33 -21
  37. package/dist/cjs/inference/inbox.js +37 -35
  38. package/dist/cjs/inference/modelDocumentation.js +16 -14
  39. package/dist/cjs/inference/money.js +5 -4
  40. package/dist/cjs/inference/priceVersion.js +10 -5
  41. package/dist/cjs/inference/providerConnection.js +21 -14
  42. package/dist/cjs/inference/realtime.js +88 -47
  43. package/dist/cjs/inference/request.js +27 -25
  44. package/dist/cjs/inference/routingPolicy.js +12 -10
  45. package/dist/cjs/inference/streamEvents.js +22 -16
  46. package/dist/cjs/inference/usage.js +32 -15
  47. package/dist/cjs/keyRecovery.js +8 -6
  48. package/dist/cjs/keyRotation.js +5 -4
  49. package/dist/cjs/linkedAccounts.js +22 -18
  50. package/dist/cjs/moderationReputation.js +29 -27
  51. package/dist/cjs/notifications.js +25 -9
  52. package/dist/cjs/numberChecks.js +45 -0
  53. package/dist/cjs/oauth.js +14 -12
  54. package/dist/cjs/organizations.js +23 -21
  55. package/dist/cjs/products/access.js +10 -8
  56. package/dist/cjs/products/billing.js +10 -8
  57. package/dist/cjs/products/checkout.js +22 -10
  58. package/dist/cjs/products/plans.js +15 -10
  59. package/dist/cjs/protocol.js +6 -5
  60. package/dist/cjs/recommendations.js +27 -19
  61. package/dist/cjs/reputation.js +15 -13
  62. package/dist/cjs/safety.js +43 -27
  63. package/dist/cjs/serviceToken.js +81 -2
  64. package/dist/cjs/sessionRevocation.js +8 -6
  65. package/dist/cjs/signIn.js +50 -24
  66. package/dist/cjs/stickers.js +19 -15
  67. package/dist/cjs/stringChecks.js +70 -0
  68. package/dist/cjs/transparency.js +14 -12
  69. package/dist/cjs/updates.js +24 -22
  70. package/dist/cjs/userInvalidation.js +7 -5
  71. package/dist/cjs/userResponse.js +8 -7
  72. package/dist/cjs/username.js +7 -6
  73. package/dist/esm/accountAccess.js +4 -3
  74. package/dist/esm/accountEmail.js +13 -5
  75. package/dist/esm/accountGraph.js +8 -7
  76. package/dist/esm/accountName.js +3 -2
  77. package/dist/esm/agency.js +90 -33
  78. package/dist/esm/agentKeys.js +21 -17
  79. package/dist/esm/appAssertions.js +11 -10
  80. package/dist/esm/applicationRoles.js +16 -9
  81. package/dist/esm/campaignAttribution.js +25 -0
  82. package/dist/esm/civic.js +8 -7
  83. package/dist/esm/client/campaignAttribution.js +10 -0
  84. package/dist/esm/client/check.js +61 -53
  85. package/dist/esm/client/index.js +2 -0
  86. package/dist/esm/client/language.js +4 -0
  87. package/dist/esm/consoleOnboarding.js +7 -2
  88. package/dist/esm/contentClaims.js +23 -14
  89. package/dist/esm/deviceDirectory.js +11 -9
  90. package/dist/esm/deviceSession.js +27 -25
  91. package/dist/esm/email/messages.js +18 -16
  92. package/dist/esm/emailAgentContext.js +11 -9
  93. package/dist/esm/externalIdentity.js +15 -11
  94. package/dist/esm/federationInstanceFetch.js +10 -5
  95. package/dist/esm/identity.js +17 -15
  96. package/dist/esm/identityLink.js +6 -4
  97. package/dist/esm/identityProof.js +6 -4
  98. package/dist/esm/inboxPush.js +3 -2
  99. package/dist/esm/index.js +5 -2
  100. package/dist/esm/inference/accountBilling.js +33 -31
  101. package/dist/esm/inference/aliaModelRelease.js +7 -5
  102. package/dist/esm/inference/attribution.js +14 -12
  103. package/dist/esm/inference/catalogue.js +33 -27
  104. package/dist/esm/inference/economics.js +22 -17
  105. package/dist/esm/inference/embeddings.js +9 -7
  106. package/dist/esm/inference/entitlement.js +15 -13
  107. package/dist/esm/inference/errors.js +13 -6
  108. package/dist/esm/inference/identifiers.js +31 -19
  109. package/dist/esm/inference/inbox.js +37 -35
  110. package/dist/esm/inference/modelDocumentation.js +14 -12
  111. package/dist/esm/inference/money.js +3 -2
  112. package/dist/esm/inference/priceVersion.js +8 -3
  113. package/dist/esm/inference/providerConnection.js +19 -12
  114. package/dist/esm/inference/realtime.js +85 -44
  115. package/dist/esm/inference/request.js +25 -23
  116. package/dist/esm/inference/routingPolicy.js +9 -7
  117. package/dist/esm/inference/streamEvents.js +20 -14
  118. package/dist/esm/inference/usage.js +30 -13
  119. package/dist/esm/keyRecovery.js +8 -6
  120. package/dist/esm/keyRotation.js +5 -4
  121. package/dist/esm/linkedAccounts.js +20 -16
  122. package/dist/esm/moderationReputation.js +27 -25
  123. package/dist/esm/notifications.js +23 -7
  124. package/dist/esm/numberChecks.js +41 -0
  125. package/dist/esm/oauth.js +14 -12
  126. package/dist/esm/organizations.js +23 -21
  127. package/dist/esm/products/access.js +10 -8
  128. package/dist/esm/products/billing.js +10 -8
  129. package/dist/esm/products/checkout.js +22 -10
  130. package/dist/esm/products/plans.js +15 -10
  131. package/dist/esm/protocol.js +4 -3
  132. package/dist/esm/recommendations.js +25 -17
  133. package/dist/esm/reputation.js +13 -11
  134. package/dist/esm/safety.js +43 -27
  135. package/dist/esm/serviceToken.js +80 -1
  136. package/dist/esm/sessionRevocation.js +6 -4
  137. package/dist/esm/signIn.js +50 -24
  138. package/dist/esm/stickers.js +17 -13
  139. package/dist/esm/stringChecks.js +63 -0
  140. package/dist/esm/transparency.js +14 -12
  141. package/dist/esm/updates.js +22 -20
  142. package/dist/esm/userInvalidation.js +4 -2
  143. package/dist/esm/userResponse.js +4 -3
  144. package/dist/esm/username.js +3 -2
  145. package/dist/types/accountAccess.d.ts +29 -70
  146. package/dist/types/accountEmail.d.ts +2 -14
  147. package/dist/types/accountGraph.d.ts +179 -171
  148. package/dist/types/accountName.d.ts +1 -1
  149. package/dist/types/accountSubject.d.ts +20 -93
  150. package/dist/types/agency.d.ts +528 -2924
  151. package/dist/types/agentKeys.d.ts +48 -421
  152. package/dist/types/appAssertions.d.ts +56 -210
  153. package/dist/types/applicationRoles.d.ts +30 -276
  154. package/dist/types/avatarCharacter.d.ts +1 -1
  155. package/dist/types/campaignAttribution.d.ts +10 -0
  156. package/dist/types/civic.d.ts +1 -13
  157. package/dist/types/client/agentKeys.d.ts +18 -18
  158. package/dist/types/client/appAssertions.d.ts +3 -3
  159. package/dist/types/client/campaignAttribution.d.ts +12 -0
  160. package/dist/types/client/check.d.ts +13 -13
  161. package/dist/types/client/deviceDirectory.d.ts +51 -51
  162. package/dist/types/client/deviceSession.d.ts +14 -14
  163. package/dist/types/client/index.d.ts +3 -0
  164. package/dist/types/client/language.d.ts +2 -0
  165. package/dist/types/client/organizations.d.ts +25 -25
  166. package/dist/types/client/products.d.ts +33 -33
  167. package/dist/types/client/recommendations.d.ts +2 -2
  168. package/dist/types/client/safety.d.ts +45 -45
  169. package/dist/types/client/sessionStatus.d.ts +4 -4
  170. package/dist/types/client/signIn.d.ts +1 -1
  171. package/dist/types/commonsSignIn.d.ts +4 -1
  172. package/dist/types/consoleOnboarding.d.ts +24 -44
  173. package/dist/types/contentClaims.d.ts +24 -180
  174. package/dist/types/deviceDirectory.d.ts +109 -1040
  175. package/dist/types/deviceSession.d.ts +36 -298
  176. package/dist/types/email/messages.d.ts +212 -1793
  177. package/dist/types/emailAgentContext.d.ts +10 -194
  178. package/dist/types/externalIdentity.d.ts +121 -615
  179. package/dist/types/federationInstanceFetch.d.ts +3 -32
  180. package/dist/types/identity.d.ts +15 -92
  181. package/dist/types/identityLink.d.ts +6 -84
  182. package/dist/types/identityProof.d.ts +5 -17
  183. package/dist/types/inboxPush.d.ts +1 -9
  184. package/dist/types/index.d.ts +7 -3
  185. package/dist/types/inference/accountBilling.d.ts +151 -488
  186. package/dist/types/inference/aliaModelRelease.d.ts +42 -439
  187. package/dist/types/inference/attribution.d.ts +75 -104
  188. package/dist/types/inference/catalogue.d.ts +417 -1599
  189. package/dist/types/inference/economics.d.ts +69 -276
  190. package/dist/types/inference/embeddings.d.ts +110 -406
  191. package/dist/types/inference/entitlement.d.ts +80 -335
  192. package/dist/types/inference/errors.d.ts +90 -102
  193. package/dist/types/inference/identifiers.d.ts +12 -4
  194. package/dist/types/inference/inbox.d.ts +105 -420
  195. package/dist/types/inference/modelDocumentation.d.ts +201 -1390
  196. package/dist/types/inference/money.d.ts +65 -32
  197. package/dist/types/inference/priceVersion.d.ts +53 -120
  198. package/dist/types/inference/providerConnection.d.ts +253 -710
  199. package/dist/types/inference/realtime.d.ts +954 -6825
  200. package/dist/types/inference/request.d.ts +300 -2572
  201. package/dist/types/inference/routingPolicy.d.ts +95 -503
  202. package/dist/types/inference/streamEvents.d.ts +253 -721
  203. package/dist/types/inference/usage.d.ts +317 -950
  204. package/dist/types/keyRecovery.d.ts +3 -51
  205. package/dist/types/keyRotation.d.ts +3 -38
  206. package/dist/types/linkedAccounts.d.ts +50 -236
  207. package/dist/types/moderationReputation.d.ts +81 -14
  208. package/dist/types/notifications.d.ts +19 -51
  209. package/dist/types/numberChecks.d.ts +9 -0
  210. package/dist/types/oauth.d.ts +101 -809
  211. package/dist/types/organizations.d.ts +268 -921
  212. package/dist/types/oxyRecordTypes.d.ts +11 -1
  213. package/dist/types/products/access.d.ts +125 -775
  214. package/dist/types/products/billing.d.ts +67 -503
  215. package/dist/types/products/checkout.d.ts +16 -69
  216. package/dist/types/products/plans.d.ts +33 -366
  217. package/dist/types/recommendations.d.ts +76 -389
  218. package/dist/types/reputation.d.ts +37 -5
  219. package/dist/types/safety.d.ts +408 -2048
  220. package/dist/types/serviceToken.d.ts +247 -7
  221. package/dist/types/sessionRevocation.d.ts +2 -17
  222. package/dist/types/sessionStatus.d.ts +27 -115
  223. package/dist/types/signIn.d.ts +62 -553
  224. package/dist/types/stickers.d.ts +67 -819
  225. package/dist/types/stringChecks.d.ts +16 -0
  226. package/dist/types/transparency.d.ts +14 -302
  227. package/dist/types/updates.d.ts +60 -316
  228. package/dist/types/userInvalidation.d.ts +4 -13
  229. package/dist/types/userResponse.d.ts +302 -2400
  230. package/dist/types/username.d.ts +3 -3
  231. package/package.json +6 -4
@@ -1,9 +1,11 @@
1
+ import { integerCheck, safeNumberCheck } from '../numberChecks.js';
2
+ import { isoDateTime, utf16MaxLength, utf16MinLength } from '../stringChecks.js';
1
3
  import { z } from 'zod';
2
4
  import { oxyAccountIdSchema, oxyApplicationIdSchema } from '../inference/identifiers.js';
3
- const identifier = z.string().min(1).max(160);
4
- const count = z.number().int().nonnegative().safe();
5
+ const identifier = z.string().check(utf16MinLength(1)).check(utf16MaxLength(160));
6
+ const count = z.number().check(integerCheck()).nonnegative().check(safeNumberCheck());
5
7
  const period = z
6
- .object({ start: z.string().datetime(), end: z.string().datetime() })
8
+ .object({ start: z.string().check(isoDateTime()), end: z.string().check(isoDateTime()) })
7
9
  .strict()
8
10
  .refine((value) => Date.parse(value.end) > Date.parse(value.start), 'period end must follow start');
9
11
  /** Product ownership and audience are registered together; branding grants no trust. */
@@ -41,7 +43,7 @@ export const productOfferSchema = z
41
43
  .object({
42
44
  schemaVersion: z.literal(1),
43
45
  id: identifier,
44
- version: z.number().int().positive().safe(),
46
+ version: z.number().check(integerCheck()).positive().check(safeNumberCheck()),
45
47
  kind: z.enum(['individual', 'bundle']),
46
48
  benefits: z.array(productBenefitSchema),
47
49
  })
@@ -78,7 +80,7 @@ export const productOfferSegmentSchema = z
78
80
  subscriptionId: identifier,
79
81
  beneficiaryAccountId: oxyAccountIdSchema,
80
82
  offerId: identifier,
81
- offerVersion: z.number().int().positive().safe(),
83
+ offerVersion: z.number().check(integerCheck()).positive().check(safeNumberCheck()),
82
84
  origin: z.enum(['individual', 'bundle']),
83
85
  period,
84
86
  })
@@ -91,11 +93,11 @@ export const productAccessGrantSchema = z
91
93
  sourceSegmentId: identifier,
92
94
  beneficiaryAccountId: oxyAccountIdSchema,
93
95
  offerId: identifier,
94
- offerVersion: z.number().int().positive().safe(),
96
+ offerVersion: z.number().check(integerCheck()).positive().check(safeNumberCheck()),
95
97
  origin: z.enum(['individual', 'bundle']),
96
98
  benefit: productBenefitSchema,
97
99
  period,
98
- revokedAt: z.string().datetime().nullable(),
100
+ revokedAt: z.string().check(isoDateTime()).nullable(),
99
101
  })
100
102
  .strict();
101
103
  /** Access answers contain no payer, provider reference, price or account balance. */
@@ -104,7 +106,7 @@ export const subjectProductAccessSchema = z
104
106
  schemaVersion: z.literal(1),
105
107
  subjectAccountId: oxyAccountIdSchema,
106
108
  productId: identifier,
107
- evaluatedAt: z.string().datetime(),
109
+ evaluatedAt: z.string().check(isoDateTime()),
108
110
  capabilities: z.array(z.object({ key: identifier, grantIds: z.array(identifier) }).strict()),
109
111
  quotas: z.array(z
110
112
  .object({
@@ -1,10 +1,12 @@
1
+ import { integerCheck, safeNumberCheck } from '../numberChecks.js';
2
+ import { isoDateTime, utf16MaxLength, utf16MinLength } from '../stringChecks.js';
1
3
  import { z } from 'zod';
2
4
  import { oxyAccountIdSchema } from '../inference/identifiers.js';
3
- const id = z.string().min(1).max(160);
4
- const name = z.string().min(1).max(100);
5
- const count = z.number().int().nonnegative().safe();
5
+ const id = z.string().check(utf16MinLength(1)).check(utf16MaxLength(160));
6
+ const name = z.string().check(utf16MinLength(1)).check(utf16MaxLength(100));
7
+ const count = z.number().check(integerCheck()).nonnegative().check(safeNumberCheck());
6
8
  const period = z
7
- .object({ start: z.string().datetime(), end: z.string().datetime() })
9
+ .object({ start: z.string().check(isoDateTime()), end: z.string().check(isoDateTime()) })
8
10
  .strict()
9
11
  .refine((value) => Date.parse(value.end) > Date.parse(value.start), 'Period end must follow start');
10
12
  /** Self-service provenance; no payer/provider identifiers or balances in access metadata. */
@@ -29,7 +31,7 @@ export const productSubscriptionSummarySchema = z
29
31
  .object({
30
32
  segmentId: id,
31
33
  offerId: id,
32
- offerVersion: z.number().int().positive().safe(),
34
+ offerVersion: z.number().check(integerCheck()).positive().check(safeNumberCheck()),
33
35
  displayName: name,
34
36
  origin: z.enum(['individual', 'bundle']),
35
37
  period,
@@ -57,7 +59,7 @@ export const subscriptionCreditGrantSchema = z
57
59
  clawed: count,
58
60
  remaining: count,
59
61
  promotionId: id.nullable(),
60
- createdAt: z.string().datetime(),
62
+ createdAt: z.string().check(isoDateTime()),
61
63
  })
62
64
  .strict()
63
65
  .refine((value) => BigInt(value.consumed) + BigInt(value.clawed) + BigInt(value.remaining) ===
@@ -70,8 +72,8 @@ export const cancelProductSubscriptionSchema = z
70
72
  sourceId: id,
71
73
  actionId: z
72
74
  .string()
73
- .min(8)
74
- .max(160)
75
+ .check(utf16MinLength(8))
76
+ .check(utf16MaxLength(160))
75
77
  .regex(/^[a-zA-Z0-9_-]+$/)
76
78
  .optional(),
77
79
  expectedSubjectAccountId: oxyAccountIdSchema.optional(),
@@ -1,14 +1,16 @@
1
+ import { integerCheck, safeNumberCheck } from '../numberChecks.js';
2
+ import { urlCheck, utf16MaxLength, utf16MinLength } from '../stringChecks.js';
1
3
  import { z } from 'zod';
2
4
  import { oxyAccountIdSchema } from '../inference/identifiers.js';
3
5
  export const personalPlanCheckoutRequestSchema = z
4
6
  .object({
5
7
  expectedSubjectAccountId: oxyAccountIdSchema,
6
- offerId: z.string().min(1).max(160),
7
- offerVersion: z.number().int().positive().safe(),
8
+ offerId: z.string().check(utf16MinLength(1)).check(utf16MaxLength(160)),
9
+ offerVersion: z.number().check(integerCheck()).positive().check(safeNumberCheck()),
8
10
  idempotencyKey: z
9
11
  .string()
10
- .min(8)
11
- .max(160)
12
+ .check(utf16MinLength(8))
13
+ .check(utf16MaxLength(160))
12
14
  .regex(/^[a-zA-Z0-9_-]+$/),
13
15
  })
14
16
  .strict();
@@ -23,23 +25,33 @@ export const personalPlanCheckoutResultSchema = z.discriminatedUnion('state', [
23
25
  z
24
26
  .object({
25
27
  state: z.literal('pending'),
26
- intentId: z.string().min(1).max(160),
27
- checkoutUrl: z.string().url().startsWith('https://').optional(),
28
+ intentId: z.string().check(utf16MinLength(1)).check(utf16MaxLength(160)),
29
+ checkoutUrl: z.string().check(urlCheck()).startsWith('https://').optional(),
30
+ })
31
+ .strict(),
32
+ z
33
+ .object({
34
+ state: z.literal('closed'),
35
+ intentId: z.string().check(utf16MinLength(1)).check(utf16MaxLength(160)),
36
+ })
37
+ .strict(),
38
+ z
39
+ .object({
40
+ state: z.literal('fulfilled'),
41
+ intentId: z.string().check(utf16MinLength(1)).check(utf16MaxLength(160)),
28
42
  })
29
43
  .strict(),
30
- z.object({ state: z.literal('closed'), intentId: z.string().min(1).max(160) }).strict(),
31
- z.object({ state: z.literal('fulfilled'), intentId: z.string().min(1).max(160) }).strict(),
32
44
  ]);
33
45
  /** Explicit individual product offer; still owned and paid through Oxy. */
34
46
  export const productPlanCheckoutRequestSchema = personalPlanCheckoutRequestSchema
35
47
  .extend({
36
- productId: z.string().min(1).max(160),
48
+ productId: z.string().check(utf16MinLength(1)).check(utf16MaxLength(160)),
37
49
  })
38
50
  .strict();
39
51
  export const productSubscriptionRenewalRequestSchema = z
40
52
  .object({
41
53
  expectedSubjectAccountId: oxyAccountIdSchema,
42
- sourceId: z.string().min(1).max(160),
54
+ sourceId: z.string().check(utf16MinLength(1)).check(utf16MaxLength(160)),
43
55
  idempotencyKey: personalPlanCheckoutRequestSchema.shape.idempotencyKey,
44
56
  })
45
57
  .strict();
@@ -1,10 +1,12 @@
1
+ import { integerCheck, safeNumberCheck } from '../numberChecks.js';
2
+ import { utf16MaxLength, utf16MinLength } from '../stringChecks.js';
1
3
  import { z } from 'zod';
2
4
  import { productBenefitSchema } from './access.js';
3
5
  /** Approved display terms never identify or activate a billing-provider price. */
4
6
  export const personalPlanDisplayPriceSchema = z
5
7
  .object({
6
8
  currency: z.string().regex(/^[A-Z]{3}$/),
7
- amountMinorUnits: z.number().int().positive().safe(),
9
+ amountMinorUnits: z.number().check(integerCheck()).positive().check(safeNumberCheck()),
8
10
  interval: z.literal('month'),
9
11
  trial: z.literal('none'),
10
12
  taxTreatment: z.literal('inclusive'),
@@ -19,14 +21,17 @@ export const personalPlanCatalogueSchema = z
19
21
  purchase: z.enum(['unavailable', 'available']),
20
22
  plans: z.array(z
21
23
  .object({
22
- offerId: z.string().min(1).max(160),
23
- offerVersion: z.number().int().positive().safe(),
24
- displayName: z.string().min(1).max(100),
24
+ offerId: z.string().check(utf16MinLength(1)).check(utf16MaxLength(160)),
25
+ offerVersion: z.number().check(integerCheck()).positive().check(safeNumberCheck()),
26
+ displayName: z.string().check(utf16MinLength(1)).check(utf16MaxLength(100)),
25
27
  audience: z.literal('personal'),
26
28
  kind: z.literal('oxy_one'),
27
29
  price: personalPlanDisplayPriceSchema.optional(),
28
30
  benefits: z.array(z
29
- .object({ displayName: z.string().min(1).max(100), benefit: productBenefitSchema })
31
+ .object({
32
+ displayName: z.string().check(utf16MinLength(1)).check(utf16MaxLength(100)),
33
+ benefit: productBenefitSchema,
34
+ })
30
35
  .strict()),
31
36
  })
32
37
  .strict()),
@@ -36,14 +41,14 @@ export const personalPlanCatalogueSchema = z
36
41
  export const productPlanCatalogueSchema = z
37
42
  .object({
38
43
  schemaVersion: z.literal(1),
39
- productId: z.string().min(1).max(160),
44
+ productId: z.string().check(utf16MinLength(1)).check(utf16MaxLength(160)),
40
45
  purchase: z.enum(['unavailable', 'available']),
41
46
  plans: z.array(z
42
47
  .object({
43
- productId: z.string().min(1).max(160),
44
- offerId: z.string().min(1).max(160),
45
- offerVersion: z.number().int().positive().safe(),
46
- displayName: z.string().min(1).max(100),
48
+ productId: z.string().check(utf16MinLength(1)).check(utf16MaxLength(160)),
49
+ offerId: z.string().check(utf16MinLength(1)).check(utf16MaxLength(160)),
50
+ offerVersion: z.number().check(integerCheck()).positive().check(safeNumberCheck()),
51
+ displayName: z.string().check(utf16MinLength(1)).check(utf16MaxLength(100)),
47
52
  price: personalPlanDisplayPriceSchema.extend({ interval: z.enum(['month', 'year']) }),
48
53
  })
49
54
  .strict()),
@@ -1,3 +1,4 @@
1
+ import { integerCheck } from './numberChecks.js';
1
2
  /**
2
3
  * Generic "Oxy Protocol" record surface — the app-agnostic conventions every app
3
4
  * follows to decentralize its own content on the shared signed-record substrate.
@@ -41,10 +42,10 @@ import { z } from 'zod';
41
42
  import { signedRecordEnvelopeSchema } from './identity.js';
42
43
  export const chainHeadResponseSchema = z.object({
43
44
  headRecordId: z.string().nullable(),
44
- seq: z.number().int(),
45
- recordCount: z.number().int().nonnegative(),
45
+ seq: z.number().check(integerCheck()),
46
+ recordCount: z.number().check(integerCheck()).nonnegative(),
46
47
  });
47
48
  export const logPageResponseSchema = z.object({
48
49
  records: z.array(signedRecordEnvelopeSchema),
49
- count: z.number().int().nonnegative(),
50
+ count: z.number().check(integerCheck()).nonnegative(),
50
51
  });
@@ -1,3 +1,5 @@
1
+ import { integerCheck } from './numberChecks.js';
2
+ import { isoDateTime, utf16MaxLength, utf16MinLength } from './stringChecks.js';
1
3
  /**
2
4
  * Recommendation-engine API contracts.
3
5
  *
@@ -22,9 +24,12 @@ export const recommendationExcludeTypeSchema = z.enum(['federated', 'agent', 'au
22
24
  * gate — a boost cannot resurrect a private/restricted/ineligible account.
23
25
  */
24
26
  export const recommendationBoostSchema = z.object({
25
- userIds: z.array(z.string().trim().min(1)).min(1).max(200),
27
+ userIds: z
28
+ .array(z.string().trim().check(utf16MinLength(1)))
29
+ .min(1)
30
+ .max(200),
26
31
  weight: z.number().min(-5).max(5),
27
- reason: z.string().trim().max(120).optional(),
32
+ reason: z.string().trim().check(utf16MaxLength(120)).optional(),
28
33
  });
29
34
  /**
30
35
  * Per-request overrides for the scoring signal weights. Every key is optional
@@ -52,18 +57,21 @@ export const recommendationSignalWeightsSchema = z
52
57
  * ranking within server-enforced bounds.
53
58
  */
54
59
  export const recommendationRequestSchema = z.object({
55
- clientId: z.string().trim().min(1).optional(),
56
- limit: z.number().int().min(1).max(100).optional(),
57
- offset: z.number().int().min(0).optional(),
60
+ clientId: z.string().trim().check(utf16MinLength(1)).optional(),
61
+ limit: z.number().check(integerCheck()).min(1).max(100).optional(),
62
+ offset: z.number().check(integerCheck()).min(0).optional(),
58
63
  excludeTypes: z.array(recommendationExcludeTypeSchema).optional(),
59
- excludeIds: z.array(z.string().trim().min(1)).max(500).optional(),
64
+ excludeIds: z
65
+ .array(z.string().trim().check(utf16MinLength(1)))
66
+ .max(500)
67
+ .optional(),
60
68
  boosts: z.array(recommendationBoostSchema).max(50).optional(),
61
69
  signalWeights: recommendationSignalWeightsSchema.optional(),
62
70
  });
63
71
  /** Follower/following counts attached to a recommendation item. */
64
72
  export const recommendationCountSchema = z.object({
65
- followers: z.number().int().nonnegative(),
66
- following: z.number().int().nonnegative(),
73
+ followers: z.number().check(integerCheck()).nonnegative(),
74
+ following: z.number().check(integerCheck()).nonnegative(),
67
75
  });
68
76
  /**
69
77
  * A single recommended profile.
@@ -85,7 +93,7 @@ export const recommendationItemSchema = z
85
93
  description: z.string().nullable().optional(),
86
94
  verified: z.boolean().optional(),
87
95
  trustTier: z.string().optional(),
88
- mutualCount: z.number().int().nonnegative(),
96
+ mutualCount: z.number().check(integerCheck()).nonnegative(),
89
97
  score: z.number().optional(),
90
98
  matchedSignals: z.array(z.string()).optional(),
91
99
  isFederated: z.boolean().optional(),
@@ -99,14 +107,14 @@ export const recommendationItemSchema = z
99
107
  export const recommendationResponseSchema = z.array(recommendationItemSchema);
100
108
  /** One endorsement edge an app reports: `ownerId` endorses `memberId`. */
101
109
  export const appEndorsementInputSchema = z.object({
102
- ownerId: z.string().trim().min(1),
103
- memberId: z.string().trim().min(1),
110
+ ownerId: z.string().trim().check(utf16MinLength(1)),
111
+ memberId: z.string().trim().check(utf16MinLength(1)),
104
112
  op: z.enum(['add', 'remove']).default('add'),
105
- sourceId: z.string().trim().min(1).optional(),
113
+ sourceId: z.string().trim().check(utf16MinLength(1)).optional(),
106
114
  });
107
115
  /** One interest signal an app reports: how interested `userId` is in a topic. */
108
116
  export const appInterestInputSchema = z.object({
109
- userId: z.string().trim().min(1),
117
+ userId: z.string().trim().check(utf16MinLength(1)),
110
118
  interestScore: z.number().min(0).max(1),
111
119
  });
112
120
  /**
@@ -150,12 +158,12 @@ export const appAffinityEventTypeSchema = z.enum([
150
158
  * same application is folded at most once (bounded dedup window).
151
159
  */
152
160
  export const appAffinityEventSchema = z.object({
153
- fromUserId: z.string().trim().min(1),
154
- toUserId: z.string().trim().min(1),
161
+ fromUserId: z.string().trim().check(utf16MinLength(1)),
162
+ toUserId: z.string().trim().check(utf16MinLength(1)),
155
163
  type: appAffinityEventTypeSchema,
156
164
  weight: z.number().min(0).max(100).optional(),
157
- occurredAt: z.string().datetime().optional(),
158
- eventId: z.string().trim().min(1).max(200).optional(),
165
+ occurredAt: z.string().check(isoDateTime()).optional(),
166
+ eventId: z.string().trim().check(utf16MinLength(1)).check(utf16MaxLength(200)).optional(),
159
167
  });
160
168
  /**
161
169
  * Request body for `POST /app-signals/events` (service token, `signals:write`).
@@ -1,3 +1,5 @@
1
+ import { integerCheck } from './numberChecks.js';
2
+ import { utf16MaxLength, utf16MinLength } from './stringChecks.js';
1
3
  /**
2
4
  * Oxy Trust — reputation API contracts.
3
5
  *
@@ -121,7 +123,7 @@ export const reputationTransactionSchema = z.object({
121
123
  status: reputationTransactionStatusSchema,
122
124
  reversedTransactionId: z.string().optional(),
123
125
  reason: z.string().optional(),
124
- metadata: z.record(z.unknown()).optional(),
126
+ metadata: z.record(z.string(), z.unknown()).optional(),
125
127
  createdByUserId: z.string().optional(),
126
128
  reviewedByUserId: z.string().optional(),
127
129
  reviewedAt: z.string().optional(),
@@ -179,7 +181,7 @@ export const reputationRuleSchema = z.object({
179
181
  cooldownInMinutes: z.number(),
180
182
  });
181
183
  export const reputationRulesResponseSchema = z.object({
182
- version: z.number().int(),
184
+ version: z.number().check(integerCheck()),
183
185
  rules: z.array(reputationRuleSchema),
184
186
  });
185
187
  export const reputationLeaderboardUserSchema = z.object({
@@ -201,14 +203,14 @@ export const reputationInfluenceResultSchema = z.object({
201
203
  influence: reputationInfluenceSchema,
202
204
  });
203
205
  export const awardReputationSchema = z.object({
204
- userId: z.string().trim().min(1),
205
- actionType: z.string().trim().min(1),
206
- applicationId: z.string().trim().min(1).optional(),
207
- credentialId: z.string().trim().min(1).optional(),
208
- sourceActionId: z.string().trim().min(1).optional(),
209
- sourceActionType: z.string().trim().min(1).optional(),
210
- targetEntityId: z.string().trim().min(1).optional(),
206
+ userId: z.string().trim().check(utf16MinLength(1)),
207
+ actionType: z.string().trim().check(utf16MinLength(1)),
208
+ applicationId: z.string().trim().check(utf16MinLength(1)).optional(),
209
+ credentialId: z.string().trim().check(utf16MinLength(1)).optional(),
210
+ sourceActionId: z.string().trim().check(utf16MinLength(1)).optional(),
211
+ sourceActionType: z.string().trim().check(utf16MinLength(1)).optional(),
212
+ targetEntityId: z.string().trim().check(utf16MinLength(1)).optional(),
211
213
  targetEntityType: reputationTargetEntityTypeSchema.optional(),
212
- reason: z.string().trim().max(500).optional(),
213
- metadata: z.record(z.unknown()).optional(),
214
+ reason: z.string().trim().check(utf16MaxLength(500)).optional(),
215
+ metadata: z.record(z.string(), z.unknown()).optional(),
214
216
  });
@@ -1,3 +1,5 @@
1
+ import { integerCheck } from './numberChecks.js';
2
+ import { isoDateTime, utf16MaxLength, utf16MinLength } from './stringChecks.js';
1
3
  import { z } from 'zod';
2
4
  import { accountActorChainSchema } from './accountSubject.js';
3
5
  // The Zod-free half of this contract lives in `./client/` (`@oxy.so/contracts/client`);
@@ -9,7 +11,7 @@ import { userResponseSchema } from './userResponse.js';
9
11
  export { PURCHASE_APPROVAL_STATUSES, SAFETY_POLICY_VERSION, SUPERVISED_ACTIONS, SUPERVISION_CHANGED_EVENT, SUPERVISION_CONSENT_VERSION, SUPERVISION_INVITATION_STATUSES, SUPERVISION_STATUSES, };
10
12
  /** The requester is authenticated by the bearer; applications cannot submit viewer IDs. */
11
13
  export const profileAccessInputSchema = z
12
- .object({ subjectAccountId: z.string().min(1).max(128) })
14
+ .object({ subjectAccountId: z.string().check(utf16MinLength(1)).check(utf16MaxLength(128)) })
13
15
  .strict();
14
16
  export const profileAccessDecisionSchema = z
15
17
  .object({
@@ -31,8 +33,8 @@ export const SAFETY_DECISION_REASONS = [
31
33
  'unrated_content',
32
34
  'approval_required',
33
35
  ];
34
- const accountId = z.string().min(1).max(128);
35
- const resourceId = z.string().trim().min(1).max(256);
36
+ const accountId = z.string().check(utf16MinLength(1)).check(utf16MaxLength(128));
37
+ const resourceId = z.string().trim().check(utf16MinLength(1)).check(utf16MaxLength(256));
36
38
  const uniqueIds = (max, min = 1) => z
37
39
  .array(accountId)
38
40
  .min(min)
@@ -167,7 +169,7 @@ export const messagingSessionsInputSchema = z
167
169
  .array(z
168
170
  .object({
169
171
  requestId: resourceId,
170
- accessToken: z.string().min(1).max(16384),
172
+ accessToken: z.string().check(utf16MinLength(1)).check(utf16MaxLength(16384)),
171
173
  })
172
174
  .strict())
173
175
  .min(1)
@@ -187,8 +189,20 @@ export const messagingSessionsResponseSchema = z
187
189
  })
188
190
  .strict();
189
191
  export const safetyRequesterSchema = z.union([
190
- z.object({ accessToken: z.string().min(1).max(16384).nullable() }).strict(),
191
- z.object({ connectionToken: z.string().min(1).max(16384) }).strict(),
192
+ z
193
+ .object({
194
+ accessToken: z.string().check(utf16MinLength(1)).check(utf16MaxLength(16384)).nullable(),
195
+ })
196
+ .strict(),
197
+ z
198
+ .object({ connectionToken: z.string().check(utf16MinLength(1)).check(utf16MaxLength(16384)) })
199
+ .strict(),
200
+ z
201
+ .object({ capabilityTicket: z.string().check(utf16MinLength(1)).check(utf16MaxLength(16384)) })
202
+ .strict(),
203
+ z
204
+ .object({ requesterContext: z.string().check(utf16MinLength(1)).check(utf16MaxLength(16384)) })
205
+ .strict(),
192
206
  ]);
193
207
  export const supervisionSchema = z
194
208
  .object({
@@ -197,7 +211,7 @@ export const supervisionSchema = z
197
211
  status: z.enum(SUPERVISION_STATUSES),
198
212
  policyVersion: z.literal(SAFETY_POLICY_VERSION),
199
213
  consentVersion: z.literal(SUPERVISION_CONSENT_VERSION),
200
- createdAt: z.string().datetime(),
214
+ createdAt: z.string().check(isoDateTime()),
201
215
  })
202
216
  .strict();
203
217
  export const supervisionInvitationSchema = z
@@ -206,16 +220,16 @@ export const supervisionInvitationSchema = z
206
220
  childAccountId: accountId,
207
221
  guardianAccountId: accountId,
208
222
  status: z.enum(SUPERVISION_INVITATION_STATUSES),
209
- expiresAt: z.string().datetime(),
223
+ expiresAt: z.string().check(isoDateTime()),
210
224
  consentVersion: z.literal(SUPERVISION_CONSENT_VERSION),
211
- createdAt: z.string().datetime(),
225
+ createdAt: z.string().check(isoDateTime()),
212
226
  })
213
227
  .strict();
214
228
  export const supervisionContactSchema = z
215
229
  .object({
216
230
  childAccountId: accountId,
217
231
  contactAccountId: accountId,
218
- approvedAt: z.string().datetime(),
232
+ approvedAt: z.string().check(isoDateTime()),
219
233
  })
220
234
  .strict();
221
235
  export const supervisionStateSchema = z
@@ -229,14 +243,14 @@ export const supervisionContactsResponseSchema = z
229
243
  .object({ items: z.array(supervisionContactSchema).max(1000) })
230
244
  .strict();
231
245
  const fingerprint = z.string().regex(/^[a-f0-9]{64}$/);
232
- const minorUnits = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
246
+ const minorUnits = z.number().check(integerCheck()).nonnegative().max(Number.MAX_SAFE_INTEGER);
233
247
  export const purchaseApprovalLineSchema = z
234
248
  .object({
235
249
  itemReference: resourceId,
236
- title: z.string().trim().min(1).max(300),
237
- optionsText: z.string().trim().max(300),
250
+ title: z.string().trim().check(utf16MinLength(1)).check(utf16MaxLength(300)),
251
+ optionsText: z.string().trim().check(utf16MaxLength(300)),
238
252
  merchantAccountId: accountId,
239
- quantity: z.number().int().min(1).max(1000000),
253
+ quantity: z.number().check(integerCheck()).min(1).max(1000000),
240
254
  unitAmountMinor: minorUnits,
241
255
  lineAmountMinor: minorUnits,
242
256
  })
@@ -246,7 +260,7 @@ const purchaseEffectsObject = z
246
260
  operationId: resourceId,
247
261
  resourceId,
248
262
  cartFingerprint: fingerprint,
249
- summary: z.string().trim().min(1).max(300),
263
+ summary: z.string().trim().check(utf16MinLength(1)).check(utf16MaxLength(300)),
250
264
  merchantAccountIds: z
251
265
  .array(accountId)
252
266
  .min(1)
@@ -259,13 +273,13 @@ const purchaseEffectsObject = z
259
273
  discountMinor: minorUnits,
260
274
  roundingAdjustmentMinor: z
261
275
  .number()
262
- .int()
276
+ .check(integerCheck())
263
277
  .min(-Number.MAX_SAFE_INTEGER)
264
278
  .max(Number.MAX_SAFE_INTEGER),
265
279
  paymentFingerprint: fingerprint,
266
280
  amountMinor: minorUnits,
267
281
  currency: z.string().regex(/^[A-Z]{3}$/),
268
- expiresAt: z.string().datetime(),
282
+ expiresAt: z.string().check(isoDateTime()),
269
283
  })
270
284
  .strict();
271
285
  function validatePurchaseEvidence(value, ctx) {
@@ -308,8 +322,8 @@ const purchaseApprovalFields = {
308
322
  childAccountId: accountId,
309
323
  applicationId: accountId,
310
324
  status: z.enum(PURCHASE_APPROVAL_STATUSES),
311
- createdAt: z.string().datetime(),
312
- receiptReference: z.string().max(512).nullable(),
325
+ createdAt: z.string().check(isoDateTime()),
326
+ receiptReference: z.string().check(utf16MaxLength(512)).nullable(),
313
327
  };
314
328
  export const purchaseApprovalSchema = purchaseEffectsObject
315
329
  .extend(purchaseApprovalFields)
@@ -333,7 +347,7 @@ export const confirmPurchaseSchema = z
333
347
  .object({
334
348
  approvalId: accountId,
335
349
  operationId: resourceId,
336
- receiptReference: z.string().trim().min(1).max(512),
350
+ receiptReference: z.string().trim().check(utf16MinLength(1)).check(utf16MaxLength(512)),
337
351
  })
338
352
  .strict();
339
353
  export const cancelPurchaseSchema = confirmPurchaseSchema.omit({ receiptReference: true });
@@ -370,7 +384,7 @@ export const supervisionReviewInputSchema = z
370
384
  childAccountId: accountId,
371
385
  action: z.enum(['end', 'transfer']),
372
386
  guardianAccountId: accountId.optional(),
373
- evidenceReference: z.string().trim().min(1).max(2048),
387
+ evidenceReference: z.string().trim().check(utf16MinLength(1)).check(utf16MaxLength(2048)),
374
388
  reauth: reauthProofSchema,
375
389
  })
376
390
  .strict();
@@ -380,7 +394,7 @@ export const purchaseReviewInputSchema = z
380
394
  export const safetySessionInputSchema = z
381
395
  .object({
382
396
  sessionId: accountId,
383
- accessToken: z.string().min(1).max(16384),
397
+ accessToken: z.string().check(utf16MinLength(1)).check(utf16MaxLength(16384)),
384
398
  action: z.enum(SUPERVISED_ACTIONS),
385
399
  })
386
400
  .strict();
@@ -388,8 +402,8 @@ export const safetySessionValidationSchema = z
388
402
  .object({
389
403
  valid: z.literal(true),
390
404
  sessionId: accountId,
391
- expiresAt: z.string().datetime(),
392
- lastActivity: z.string().datetime(),
405
+ expiresAt: z.string().check(isoDateTime()),
406
+ lastActivity: z.string().check(isoDateTime()),
393
407
  user: userResponseSchema,
394
408
  actor: accountActorChainSchema,
395
409
  })
@@ -399,7 +413,9 @@ export const safetyPersonSchema = z
399
413
  .object({ accountId, username: z.string().nullable(), displayName: z.string().nullable() })
400
414
  .strict();
401
415
  export const safetyPeopleInputSchema = z.union([
402
- z.object({ query: z.string().trim().min(2).max(100) }).strict(),
416
+ z
417
+ .object({ query: z.string().trim().check(utf16MinLength(2)).check(utf16MaxLength(100)) })
418
+ .strict(),
403
419
  z.object({ accountIds: uniqueIds(100) }).strict(),
404
420
  ]);
405
421
  export const safetyPeopleResponseSchema = z
@@ -417,8 +433,8 @@ export const safetyOrganizationIdentitySchema = z
417
433
  export const safetyOrganizationsInputSchema = z.union([
418
434
  z
419
435
  .object({
420
- query: z.string().trim().min(1).max(100),
421
- limit: z.number().int().min(1).max(20).optional(),
436
+ query: z.string().trim().check(utf16MinLength(1)).check(utf16MaxLength(100)),
437
+ limit: z.number().check(integerCheck()).min(1).max(20).optional(),
422
438
  })
423
439
  .strict(),
424
440
  z.object({ ids: uniqueIds(100) }).strict(),