@oxy.so/contracts 5.7.0 → 6.0.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 (227) 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/civic.js +10 -9
  10. package/dist/cjs/client/check.js +61 -53
  11. package/dist/cjs/client/consoleOnboarding.js +24 -0
  12. package/dist/cjs/client/index.js +7 -3
  13. package/dist/cjs/client/safety.js +9 -1
  14. package/dist/cjs/consoleOnboarding.js +56 -0
  15. package/dist/cjs/contentClaims.js +23 -14
  16. package/dist/cjs/deviceDirectory.js +11 -9
  17. package/dist/cjs/deviceSession.js +27 -25
  18. package/dist/cjs/email/messages.js +20 -18
  19. package/dist/cjs/emailAgentContext.js +11 -9
  20. package/dist/cjs/externalIdentity.js +15 -11
  21. package/dist/cjs/federationInstanceFetch.js +12 -7
  22. package/dist/cjs/identity.js +19 -17
  23. package/dist/cjs/identityLink.js +6 -4
  24. package/dist/cjs/identityProof.js +6 -4
  25. package/dist/cjs/inboxPush.js +5 -4
  26. package/dist/cjs/index.js +16 -6
  27. package/dist/cjs/inference/accountBilling.js +35 -33
  28. package/dist/cjs/inference/aliaModelRelease.js +9 -7
  29. package/dist/cjs/inference/attribution.js +14 -12
  30. package/dist/cjs/inference/catalogue.js +35 -29
  31. package/dist/cjs/inference/economics.js +24 -19
  32. package/dist/cjs/inference/embeddings.js +9 -7
  33. package/dist/cjs/inference/entitlement.js +17 -15
  34. package/dist/cjs/inference/errors.js +15 -8
  35. package/dist/cjs/inference/identifiers.js +33 -21
  36. package/dist/cjs/inference/inbox.js +37 -35
  37. package/dist/cjs/inference/modelDocumentation.js +16 -14
  38. package/dist/cjs/inference/money.js +5 -4
  39. package/dist/cjs/inference/priceVersion.js +10 -5
  40. package/dist/cjs/inference/providerConnection.js +21 -14
  41. package/dist/cjs/inference/realtime.js +88 -47
  42. package/dist/cjs/inference/request.js +27 -25
  43. package/dist/cjs/inference/routingPolicy.js +12 -10
  44. package/dist/cjs/inference/streamEvents.js +22 -16
  45. package/dist/cjs/inference/usage.js +32 -15
  46. package/dist/cjs/keyRecovery.js +8 -6
  47. package/dist/cjs/keyRotation.js +5 -4
  48. package/dist/cjs/linkedAccounts.js +22 -18
  49. package/dist/cjs/moderationReputation.js +29 -27
  50. package/dist/cjs/notifications.js +25 -9
  51. package/dist/cjs/numberChecks.js +45 -0
  52. package/dist/cjs/oauth.js +14 -12
  53. package/dist/cjs/organizations.js +23 -21
  54. package/dist/cjs/products/access.js +10 -8
  55. package/dist/cjs/products/billing.js +10 -8
  56. package/dist/cjs/products/checkout.js +22 -10
  57. package/dist/cjs/products/plans.js +15 -10
  58. package/dist/cjs/protocol.js +6 -5
  59. package/dist/cjs/recommendations.js +27 -19
  60. package/dist/cjs/reputation.js +15 -13
  61. package/dist/cjs/safety.js +46 -29
  62. package/dist/cjs/serviceToken.js +81 -2
  63. package/dist/cjs/sessionRevocation.js +8 -6
  64. package/dist/cjs/signIn.js +42 -24
  65. package/dist/cjs/stickers.js +19 -15
  66. package/dist/cjs/stringChecks.js +70 -0
  67. package/dist/cjs/transparency.js +14 -12
  68. package/dist/cjs/updates.js +24 -22
  69. package/dist/cjs/userInvalidation.js +7 -5
  70. package/dist/cjs/userResponse.js +8 -7
  71. package/dist/cjs/username.js +7 -6
  72. package/dist/esm/accountAccess.js +4 -3
  73. package/dist/esm/accountEmail.js +13 -5
  74. package/dist/esm/accountGraph.js +8 -7
  75. package/dist/esm/accountName.js +3 -2
  76. package/dist/esm/agency.js +90 -33
  77. package/dist/esm/agentKeys.js +21 -17
  78. package/dist/esm/appAssertions.js +11 -10
  79. package/dist/esm/applicationRoles.js +16 -9
  80. package/dist/esm/civic.js +8 -7
  81. package/dist/esm/client/check.js +61 -53
  82. package/dist/esm/client/consoleOnboarding.js +21 -0
  83. package/dist/esm/client/index.js +2 -1
  84. package/dist/esm/client/safety.js +8 -0
  85. package/dist/esm/consoleOnboarding.js +51 -0
  86. package/dist/esm/contentClaims.js +23 -14
  87. package/dist/esm/deviceDirectory.js +11 -9
  88. package/dist/esm/deviceSession.js +27 -25
  89. package/dist/esm/email/messages.js +18 -16
  90. package/dist/esm/emailAgentContext.js +11 -9
  91. package/dist/esm/externalIdentity.js +15 -11
  92. package/dist/esm/federationInstanceFetch.js +10 -5
  93. package/dist/esm/identity.js +17 -15
  94. package/dist/esm/identityLink.js +6 -4
  95. package/dist/esm/identityProof.js +6 -4
  96. package/dist/esm/inboxPush.js +3 -2
  97. package/dist/esm/index.js +5 -2
  98. package/dist/esm/inference/accountBilling.js +33 -31
  99. package/dist/esm/inference/aliaModelRelease.js +7 -5
  100. package/dist/esm/inference/attribution.js +14 -12
  101. package/dist/esm/inference/catalogue.js +33 -27
  102. package/dist/esm/inference/economics.js +22 -17
  103. package/dist/esm/inference/embeddings.js +9 -7
  104. package/dist/esm/inference/entitlement.js +15 -13
  105. package/dist/esm/inference/errors.js +13 -6
  106. package/dist/esm/inference/identifiers.js +31 -19
  107. package/dist/esm/inference/inbox.js +37 -35
  108. package/dist/esm/inference/modelDocumentation.js +14 -12
  109. package/dist/esm/inference/money.js +3 -2
  110. package/dist/esm/inference/priceVersion.js +8 -3
  111. package/dist/esm/inference/providerConnection.js +19 -12
  112. package/dist/esm/inference/realtime.js +85 -44
  113. package/dist/esm/inference/request.js +25 -23
  114. package/dist/esm/inference/routingPolicy.js +9 -7
  115. package/dist/esm/inference/streamEvents.js +20 -14
  116. package/dist/esm/inference/usage.js +30 -13
  117. package/dist/esm/keyRecovery.js +8 -6
  118. package/dist/esm/keyRotation.js +5 -4
  119. package/dist/esm/linkedAccounts.js +20 -16
  120. package/dist/esm/moderationReputation.js +27 -25
  121. package/dist/esm/notifications.js +23 -7
  122. package/dist/esm/numberChecks.js +41 -0
  123. package/dist/esm/oauth.js +14 -12
  124. package/dist/esm/organizations.js +23 -21
  125. package/dist/esm/products/access.js +10 -8
  126. package/dist/esm/products/billing.js +10 -8
  127. package/dist/esm/products/checkout.js +22 -10
  128. package/dist/esm/products/plans.js +15 -10
  129. package/dist/esm/protocol.js +4 -3
  130. package/dist/esm/recommendations.js +25 -17
  131. package/dist/esm/reputation.js +13 -11
  132. package/dist/esm/safety.js +45 -29
  133. package/dist/esm/serviceToken.js +80 -1
  134. package/dist/esm/sessionRevocation.js +6 -4
  135. package/dist/esm/signIn.js +42 -24
  136. package/dist/esm/stickers.js +17 -13
  137. package/dist/esm/stringChecks.js +63 -0
  138. package/dist/esm/transparency.js +14 -12
  139. package/dist/esm/updates.js +22 -20
  140. package/dist/esm/userInvalidation.js +4 -2
  141. package/dist/esm/userResponse.js +4 -3
  142. package/dist/esm/username.js +3 -2
  143. package/dist/types/accountAccess.d.ts +29 -70
  144. package/dist/types/accountEmail.d.ts +2 -14
  145. package/dist/types/accountGraph.d.ts +179 -171
  146. package/dist/types/accountName.d.ts +1 -1
  147. package/dist/types/accountSubject.d.ts +20 -93
  148. package/dist/types/agency.d.ts +528 -2924
  149. package/dist/types/agentKeys.d.ts +48 -421
  150. package/dist/types/appAssertions.d.ts +56 -210
  151. package/dist/types/applicationRoles.d.ts +30 -276
  152. package/dist/types/avatarCharacter.d.ts +1 -1
  153. package/dist/types/civic.d.ts +1 -13
  154. package/dist/types/client/agentKeys.d.ts +18 -18
  155. package/dist/types/client/appAssertions.d.ts +3 -3
  156. package/dist/types/client/check.d.ts +13 -13
  157. package/dist/types/client/consoleOnboarding.d.ts +16 -0
  158. package/dist/types/client/deviceDirectory.d.ts +51 -51
  159. package/dist/types/client/deviceSession.d.ts +14 -14
  160. package/dist/types/client/index.d.ts +2 -1
  161. package/dist/types/client/organizations.d.ts +25 -25
  162. package/dist/types/client/products.d.ts +33 -33
  163. package/dist/types/client/recommendations.d.ts +2 -2
  164. package/dist/types/client/safety.d.ts +53 -45
  165. package/dist/types/client/sessionStatus.d.ts +4 -4
  166. package/dist/types/client/signIn.d.ts +1 -1
  167. package/dist/types/commonsSignIn.d.ts +4 -1
  168. package/dist/types/consoleOnboarding.d.ts +57 -0
  169. package/dist/types/contentClaims.d.ts +24 -180
  170. package/dist/types/deviceDirectory.d.ts +109 -1040
  171. package/dist/types/deviceSession.d.ts +36 -298
  172. package/dist/types/email/messages.d.ts +212 -1793
  173. package/dist/types/emailAgentContext.d.ts +10 -194
  174. package/dist/types/externalIdentity.d.ts +121 -615
  175. package/dist/types/federationInstanceFetch.d.ts +3 -32
  176. package/dist/types/identity.d.ts +15 -92
  177. package/dist/types/identityLink.d.ts +6 -84
  178. package/dist/types/identityProof.d.ts +5 -17
  179. package/dist/types/inboxPush.d.ts +1 -9
  180. package/dist/types/index.d.ts +6 -3
  181. package/dist/types/inference/accountBilling.d.ts +151 -488
  182. package/dist/types/inference/aliaModelRelease.d.ts +42 -439
  183. package/dist/types/inference/attribution.d.ts +75 -104
  184. package/dist/types/inference/catalogue.d.ts +417 -1599
  185. package/dist/types/inference/economics.d.ts +69 -276
  186. package/dist/types/inference/embeddings.d.ts +110 -406
  187. package/dist/types/inference/entitlement.d.ts +80 -335
  188. package/dist/types/inference/errors.d.ts +90 -102
  189. package/dist/types/inference/identifiers.d.ts +12 -4
  190. package/dist/types/inference/inbox.d.ts +105 -420
  191. package/dist/types/inference/modelDocumentation.d.ts +201 -1390
  192. package/dist/types/inference/money.d.ts +65 -32
  193. package/dist/types/inference/priceVersion.d.ts +53 -120
  194. package/dist/types/inference/providerConnection.d.ts +253 -710
  195. package/dist/types/inference/realtime.d.ts +954 -6825
  196. package/dist/types/inference/request.d.ts +300 -2572
  197. package/dist/types/inference/routingPolicy.d.ts +95 -503
  198. package/dist/types/inference/streamEvents.d.ts +253 -721
  199. package/dist/types/inference/usage.d.ts +317 -950
  200. package/dist/types/keyRecovery.d.ts +3 -51
  201. package/dist/types/keyRotation.d.ts +3 -38
  202. package/dist/types/linkedAccounts.d.ts +50 -236
  203. package/dist/types/moderationReputation.d.ts +81 -14
  204. package/dist/types/notifications.d.ts +19 -51
  205. package/dist/types/numberChecks.d.ts +9 -0
  206. package/dist/types/oauth.d.ts +101 -809
  207. package/dist/types/organizations.d.ts +268 -921
  208. package/dist/types/oxyRecordTypes.d.ts +11 -1
  209. package/dist/types/products/access.d.ts +125 -775
  210. package/dist/types/products/billing.d.ts +67 -503
  211. package/dist/types/products/checkout.d.ts +16 -69
  212. package/dist/types/products/plans.d.ts +33 -366
  213. package/dist/types/recommendations.d.ts +76 -389
  214. package/dist/types/reputation.d.ts +37 -5
  215. package/dist/types/safety.d.ts +410 -2050
  216. package/dist/types/serviceToken.d.ts +247 -7
  217. package/dist/types/sessionRevocation.d.ts +2 -17
  218. package/dist/types/sessionStatus.d.ts +27 -115
  219. package/dist/types/signIn.d.ts +53 -553
  220. package/dist/types/stickers.d.ts +67 -819
  221. package/dist/types/stringChecks.d.ts +16 -0
  222. package/dist/types/transparency.d.ts +14 -302
  223. package/dist/types/updates.d.ts +60 -316
  224. package/dist/types/userInvalidation.d.ts +4 -13
  225. package/dist/types/userResponse.d.ts +302 -2400
  226. package/dist/types/username.d.ts +3 -3
  227. package/package.json +3 -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,15 +1,17 @@
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`);
4
6
  // its vocabularies are re-exported here so the root entry is unchanged.
5
- import { PURCHASE_APPROVAL_STATUSES, SAFETY_POLICY_VERSION, SUPERVISED_ACTIONS, SUPERVISION_CONSENT_VERSION, SUPERVISION_INVITATION_STATUSES, SUPERVISION_STATUSES, } from './client/safety.js';
7
+ import { PURCHASE_APPROVAL_STATUSES, SAFETY_POLICY_VERSION, SUPERVISED_ACTIONS, SUPERVISION_CHANGED_EVENT, SUPERVISION_CONSENT_VERSION, SUPERVISION_INVITATION_STATUSES, SUPERVISION_STATUSES, } from './client/safety.js';
6
8
  import { ORGANIZATION_TYPES } from './organizations.js';
7
9
  import { reauthProofSchema } from './signIn.js';
8
10
  import { userResponseSchema } from './userResponse.js';
9
- export { PURCHASE_APPROVAL_STATUSES, SAFETY_POLICY_VERSION, SUPERVISED_ACTIONS, SUPERVISION_CONSENT_VERSION, SUPERVISION_INVITATION_STATUSES, SUPERVISION_STATUSES, };
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(),