@dork-labs/cloud-api 0.81.0 → 0.82.0

package/dist/primitives.d.ts

@@ -85,4 +85,53 @@ export declare function pageOf<T extends z.ZodTypeAny>(item: T, description: str
     items: z.ZodArray<T>;
     nextCursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * A link a person may be sent to: `https:` and nothing else.
+ *
+ * A plain `url()` accepts any scheme, including `javascript:`, `file:` and
+ * `data:`, and a link this contract hands to a browser must never be one of
+ * those. The scheme is checked twice on purpose: once by the URL parser, and
+ * once as a `pattern` that reaches the generated JSON Schema, so a consumer
+ * validating from the JSON Schema alone refuses the same values.
+ */
+export declare const HttpsUrlSchema: z.ZodURL;
+/**
+ * A link to a server the DorkOS app talks to: `https:`, or plain `http:` to
+ * this machine's loopback address only.
+ *
+ * Loopback `http:` is allowed so a service and a server running side by side on
+ * one machine (development, a self-hosted test) can describe each other. Any
+ * other `http:` host, and every other scheme, is refused.
+ */
+export declare const ServerUrlSchema: z.ZodURL;
+/**
+ * The metadata key that marks a field as a one-time credential.
+ *
+ * Set on a schema with `.meta()`, so it reaches the generated JSON Schema as
+ * well as the runtime registry (`z.globalRegistry.get(schema)`). A consumer
+ * that relays a response (the DorkOS server relaying to its browser, for
+ * instance) can refuse to pass any marked field on, and this package's tests
+ * prove marked fields appear only where the contract says they may.
+ */
+export declare const ONE_TIME_CREDENTIAL_META: "x-dorkos-one-time-credential";
+/**
+ * What a tolerant enum field reads as when the service sends a value this
+ * release does not know.
+ */
+export declare const UNRECOGNISED: "unrecognised";
+/**
+ * Wraps a published enum so a value added in a later release reads as
+ * {@link UNRECOGNISED} instead of failing the whole response.
+ *
+ * The additive rule lets the service add enum members in a minor release. For
+ * a field inside a list or a poll, a strict enum would turn one new state on
+ * one item into a failed parse of the whole page. This keeps every other item
+ * and gives the app one value to render generically ("in a state this version
+ * does not know"). A value that is not a string at all still fails: tolerance
+ * is for new members, not for a broken response. The known set stays published
+ * as the wrapped enum itself, so a consumer can still narrow on it.
+ *
+ * @param known - The published enum of known members.
+ */
+export declare function tolerantEnum<T extends z.ZodEnum>(known: T): z.ZodUnion<readonly [T, z.ZodPipe<z.ZodString, z.ZodTransform<"unrecognised", string>>]>;
 //# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAG,CAAU,CAAC;AAEvC,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,EAAG,KAAc,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAG,eAAwB,CAAC;AAE5D,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,QAAuB,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,kBAEmC,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,aAGkE,CAAC;AAExF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,aAQ3B,CAAC;AAEJ;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,aAQnC,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,aAK3B,CAAC;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,YAAY,aAG6D,CAAC;AAEvF,kEAAkE;AAClE,eAAO,MAAM,gBAAgB;;;iBAa4D,CAAC;AAE1F,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM;;;kBAS1E"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAG,CAAU,CAAC;AAEvC,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,EAAG,KAAc,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAG,eAAwB,CAAC;AAE5D,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,QAAuB,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,kBAEmC,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,aAGkE,CAAC;AAExF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,aAQ3B,CAAC;AAEJ;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,aAQnC,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,aAK3B,CAAC;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,YAAY,aAG6D,CAAC;AAEvF,kEAAkE;AAClE,eAAO,MAAM,gBAAgB;;;iBAa4D,CAAC;AAE1F,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM;;;kBAS1E;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,UAGyC,CAAC;AAErE;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,UAMwD,CAAC;AAErF;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,EAAG,8BAAuC,CAAC;AAEhF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAG,cAAuB,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,4FAQzD"}

package/dist/primitives.js

@@ -112,4 +112,67 @@ export function pageOf(item, description) {
     })
         .describe(description);
 }
+/**
+ * A link a person may be sent to: `https:` and nothing else.
+ *
+ * A plain `url()` accepts any scheme, including `javascript:`, `file:` and
+ * `data:`, and a link this contract hands to a browser must never be one of
+ * those. The scheme is checked twice on purpose: once by the URL parser, and
+ * once as a `pattern` that reaches the generated JSON Schema, so a consumer
+ * validating from the JSON Schema alone refuses the same values.
+ */
+export const HttpsUrlSchema = z
+    .url({ protocol: /^https$/ })
+    .regex(/^https:\/\//, 'must be an https: link')
+    .describe('An absolute https: link. Any other scheme is refused.');
+/**
+ * A link to a server the DorkOS app talks to: `https:`, or plain `http:` to
+ * this machine's loopback address only.
+ *
+ * Loopback `http:` is allowed so a service and a server running side by side on
+ * one machine (development, a self-hosted test) can describe each other. Any
+ * other `http:` host, and every other scheme, is refused.
+ */
+export const ServerUrlSchema = z
+    .url({ protocol: /^https?$/ })
+    .regex(/^(https:\/\/|http:\/\/(localhost|127\.0\.0\.1|\[::1\])(:[0-9]+)?([/?#]|$))/, 'must be an https: link, or http: to a loopback address')
+    .describe('An absolute https: link, or an http: link to a loopback address only.');
+/**
+ * The metadata key that marks a field as a one-time credential.
+ *
+ * Set on a schema with `.meta()`, so it reaches the generated JSON Schema as
+ * well as the runtime registry (`z.globalRegistry.get(schema)`). A consumer
+ * that relays a response (the DorkOS server relaying to its browser, for
+ * instance) can refuse to pass any marked field on, and this package's tests
+ * prove marked fields appear only where the contract says they may.
+ */
+export const ONE_TIME_CREDENTIAL_META = 'x-dorkos-one-time-credential';
+/**
+ * What a tolerant enum field reads as when the service sends a value this
+ * release does not know.
+ */
+export const UNRECOGNISED = 'unrecognised';
+/**
+ * Wraps a published enum so a value added in a later release reads as
+ * {@link UNRECOGNISED} instead of failing the whole response.
+ *
+ * The additive rule lets the service add enum members in a minor release. For
+ * a field inside a list or a poll, a strict enum would turn one new state on
+ * one item into a failed parse of the whole page. This keeps every other item
+ * and gives the app one value to render generically ("in a state this version
+ * does not know"). A value that is not a string at all still fails: tolerance
+ * is for new members, not for a broken response. The known set stays published
+ * as the wrapped enum itself, so a consumer can still narrow on it.
+ *
+ * @param known - The published enum of known members.
+ */
+export function tolerantEnum(known) {
+    return z.union([
+        known,
+        z
+            .string()
+            .transform(() => UNRECOGNISED)
+            .describe('A value this release does not know. It reads as unrecognised.'),
+    ]);
+}
 //# sourceMappingURL=primitives.js.map

package/dist/primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAU,CAAC;AAEvC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAc,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAwB,CAAC;AAE5D,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG;KACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAC1B,QAAQ,CAAC,kDAAkD,CAAC,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAAC,0EAA0E,CAAC,CAAC;AAExF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,KAAK,CACJ,qBAAqB,EACrB,oEAAoE,CACrE;KACA,QAAQ,CACP,0GAA0G,CAC3G,CAAC;AAEJ;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,EAAE;KACR,KAAK,CACJ,eAAe,EACf,6EAA6E,CAC9E;KACA,QAAQ,CACP,4HAA4H,CAC7H,CAAC;AAEJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACP,sHAAsH,CACvH,CAAC;AAEJ;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAAC,yEAAyE,CAAC,CAAC;AAEvF,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qFAAqF,CACtF;CACJ,CAAC;KACD,QAAQ,CAAC,4EAA4E,CAAC,CAAC;AAK1F;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAyB,IAAO,EAAE,WAAmB;IACzE,OAAO,CAAC;SACL,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACpB,UAAU,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC1C,mEAAmE,CACpE;KACF,CAAC;SACD,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAU,CAAC;AAEvC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAc,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAwB,CAAC;AAE5D,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG;KACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAC1B,QAAQ,CAAC,kDAAkD,CAAC,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAAC,0EAA0E,CAAC,CAAC;AAExF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,KAAK,CACJ,qBAAqB,EACrB,oEAAoE,CACrE;KACA,QAAQ,CACP,0GAA0G,CAC3G,CAAC;AAEJ;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,EAAE;KACR,KAAK,CACJ,eAAe,EACf,6EAA6E,CAC9E;KACA,QAAQ,CACP,4HAA4H,CAC7H,CAAC;AAEJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACP,sHAAsH,CACvH,CAAC;AAEJ;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAAC,yEAAyE,CAAC,CAAC;AAEvF,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qFAAqF,CACtF;CACJ,CAAC;KACD,QAAQ,CAAC,4EAA4E,CAAC,CAAC;AAK1F;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAyB,IAAO,EAAE,WAAmB;IACzE,OAAO,CAAC;SACL,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACpB,UAAU,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC1C,mEAAmE,CACpE;KACF,CAAC;SACD,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,GAAG,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;KAC5B,KAAK,CAAC,aAAa,EAAE,wBAAwB,CAAC;KAC9C,QAAQ,CAAC,uDAAuD,CAAC,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,GAAG,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;KAC7B,KAAK,CACJ,4EAA4E,EAC5E,wDAAwD,CACzD;KACA,QAAQ,CAAC,uEAAuE,CAAC,CAAC;AAErF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,8BAAuC,CAAC;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAuB,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAsB,KAAQ;IACxD,OAAO,CAAC,CAAC,KAAK,CAAC;QACb,KAAK;QACL,CAAC;aACE,MAAM,EAAE;aACR,SAAS,CAAC,GAAwB,EAAE,CAAC,YAAY,CAAC;aAClD,QAAQ,CAAC,+DAA+D,CAAC;KAC7E,CAAC,CAAC;AACL,CAAC"}

package/dist/problem.d.ts

@@ -34,6 +34,9 @@ export declare const ProblemCodeSchema: z.ZodEnum<{
     enrolment_required: "enrolment_required";
     remote_disabled: "remote_disabled";
     address_unavailable: "address_unavailable";
+    community_name_taken: "community_name_taken";
+    community_name_reserved: "community_name_reserved";
+    import_too_large: "import_too_large";
     internal_error: "internal_error";
     temporarily_unavailable: "temporarily_unavailable";
 }>;
@@ -49,6 +52,13 @@ export type ProblemCode = z.infer<typeof ProblemCodeSchema>;
  * is an opaque identifier paired with a server-supplied display string: the
  * client renders what it is given and never switches on the value, and no
  * amount ever appears here.
+ *
+ * `actionUrl` is the other half of a refusal a person can do something about:
+ * the page, supplied by the service, where they can do it (raise an allowance,
+ * add credit, contact the host). The client opens it as given, beside `title`
+ * and `detail`, and never builds one itself. It is `https:` only, and both it and
+ * `actionLabel` are dropped rather than failing the parse when malformed: a bad
+ * link must never cost a person the refusal's own words.
  */
 export declare const ProblemSchema: z.ZodObject<{
     code: z.ZodEnum<{
@@ -79,6 +89,9 @@ export declare const ProblemSchema: z.ZodObject<{
         enrolment_required: "enrolment_required";
         remote_disabled: "remote_disabled";
         address_unavailable: "address_unavailable";
+        community_name_taken: "community_name_taken";
+        community_name_reserved: "community_name_reserved";
+        import_too_large: "import_too_large";
         internal_error: "internal_error";
         temporarily_unavailable: "temporarily_unavailable";
     }>;
@@ -90,6 +103,8 @@ export declare const ProblemSchema: z.ZodObject<{
     requiredPlanId: z.ZodOptional<z.ZodString>;
     requiredPlanDisplayName: z.ZodOptional<z.ZodString>;
     freesAt: z.ZodOptional<z.ZodISODateTime>;
+    actionUrl: z.ZodCatch<z.ZodOptional<z.ZodURL>>;
+    actionLabel: z.ZodCatch<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
 /** The error envelope every endpoint returns in place of its success body. */
 export type Problem = z.infer<typeof ProblemSchema>;

package/dist/problem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"problem.d.ts","sourceRoot":"","sources":["../src/problem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwC3B,CAAC;AAEJ,sEAAsE;AACtE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoCvB,CAAC;AAEJ,8EAA8E;AAC9E,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D"}
+{"version":3,"file":"problem.d.ts","sourceRoot":"","sources":["../src/problem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4C3B,CAAC;AAEJ,sEAAsE;AACtE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkDvB,CAAC;AAEJ,8EAA8E;AAC9E,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D"}

package/dist/problem.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { IdSchema, TimestampSchema } from './primitives.js';
+import { HttpsUrlSchema, IdSchema, TimestampSchema } from './primitives.js';
 /**
  * Every machine-readable failure code this contract can return.
  *
@@ -41,6 +41,10 @@ export const ProblemCodeSchema = z
     'enrolment_required',
     'remote_disabled',
     'address_unavailable',
+    // Hosted communities.
+    'community_name_taken',
+    'community_name_reserved',
+    'import_too_large',
     // The server's own faults.
     'internal_error',
     'temporarily_unavailable',
@@ -56,6 +60,13 @@ export const ProblemCodeSchema = z
  * is an opaque identifier paired with a server-supplied display string: the
  * client renders what it is given and never switches on the value, and no
  * amount ever appears here.
+ *
+ * `actionUrl` is the other half of a refusal a person can do something about:
+ * the page, supplied by the service, where they can do it (raise an allowance,
+ * add credit, contact the host). The client opens it as given, beside `title`
+ * and `detail`, and never builds one itself. It is `https:` only, and both it and
+ * `actionLabel` are dropped rather than failing the parse when malformed: a bad
+ * link must never cost a person the refusal's own words.
  */
 export const ProblemSchema = z
     .object({
@@ -84,6 +95,16 @@ export const ProblemSchema = z
         .optional()
         .describe('The server-supplied display string for `requiredPlanId`.'),
     freesAt: TimestampSchema.optional().describe('When the blocking condition clears, where the server can say so.'),
+    actionUrl: HttpsUrlSchema.optional()
+        .catch(undefined)
+        .describe('A page, supplied by the service, where a person can act on this refusal. An https: link; open it as given. A malformed value is dropped rather than failing the whole envelope.'),
+    actionLabel: z
+        .string()
+        .min(1)
+        .max(60)
+        .optional()
+        .catch(undefined)
+        .describe('The server-supplied text for a link or button that opens `actionUrl`. A malformed value is dropped.'),
 })
     .describe('The error envelope every endpoint in this contract returns in place of its success body.');
 /**

package/dist/problem.js.map

@@ -1 +1 @@
-{"version":3,"file":"problem.js","sourceRoot":"","sources":["../src/problem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,IAAI,CAAC;IACJ,oCAAoC;IACpC,iBAAiB;IACjB,eAAe;IACf,eAAe;IACf,WAAW;IACX,gBAAgB;IAChB,iBAAiB;IACjB,mBAAmB;IACnB,0BAA0B;IAC1B,WAAW;IACX,UAAU;IACV,qBAAqB;IACrB,cAAc;IACd,4BAA4B;IAC5B,sBAAsB;IACtB,kBAAkB;IAClB,cAAc;IACd,iBAAiB;IACjB,mBAAmB;IACnB,oBAAoB;IACpB,YAAY;IACZ,oCAAoC;IACpC,sBAAsB;IACtB,mBAAmB;IACnB,gBAAgB;IAChB,qBAAqB;IACrB,oBAAoB;IACpB,sBAAsB;IACtB,iBAAiB;IACjB,oBAAoB;IACpB,iBAAiB;IACjB,qBAAqB;IACrB,2BAA2B;IAC3B,gBAAgB;IAChB,yBAAyB;CAC1B,CAAC;KACD,QAAQ,CACP,gIAAgI,CACjI,CAAC;AAKJ;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,GAAG,CAAC;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IACrF,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0EAA0E,CAAC;IACvF,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACpC,mEAAmE,CACpE;IACD,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,WAAW,EAAE;SACb,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,cAAc,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC1C,6IAA6I,CAC9I;IACD,uBAAuB,EAAE,CAAC;SACvB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;IACvE,OAAO,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC1C,kEAAkE,CACnE;CACF,CAAC;KACD,QAAQ,CACP,0FAA0F,CAC3F,CAAC;AAKJ;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAChD,CAAC"}
+{"version":3,"file":"problem.js","sourceRoot":"","sources":["../src/problem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,IAAI,CAAC;IACJ,oCAAoC;IACpC,iBAAiB;IACjB,eAAe;IACf,eAAe;IACf,WAAW;IACX,gBAAgB;IAChB,iBAAiB;IACjB,mBAAmB;IACnB,0BAA0B;IAC1B,WAAW;IACX,UAAU;IACV,qBAAqB;IACrB,cAAc;IACd,4BAA4B;IAC5B,sBAAsB;IACtB,kBAAkB;IAClB,cAAc;IACd,iBAAiB;IACjB,mBAAmB;IACnB,oBAAoB;IACpB,YAAY;IACZ,oCAAoC;IACpC,sBAAsB;IACtB,mBAAmB;IACnB,gBAAgB;IAChB,qBAAqB;IACrB,oBAAoB;IACpB,sBAAsB;IACtB,iBAAiB;IACjB,oBAAoB;IACpB,iBAAiB;IACjB,qBAAqB;IACrB,sBAAsB;IACtB,sBAAsB;IACtB,yBAAyB;IACzB,kBAAkB;IAClB,2BAA2B;IAC3B,gBAAgB;IAChB,yBAAyB;CAC1B,CAAC;KACD,QAAQ,CACP,gIAAgI,CACjI,CAAC;AAKJ;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,GAAG,CAAC;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,gDAAgD,CAAC;IAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IACrF,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0EAA0E,CAAC;IACvF,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACpC,mEAAmE,CACpE;IACD,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,WAAW,EAAE;SACb,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,cAAc,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC1C,6IAA6I,CAC9I;IACD,uBAAuB,EAAE,CAAC;SACvB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;IACvE,OAAO,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC1C,kEAAkE,CACnE;IACD,SAAS,EAAE,cAAc,CAAC,QAAQ,EAAE;SACjC,KAAK,CAAC,SAAS,CAAC;SAChB,QAAQ,CACP,iLAAiL,CAClL;IACH,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,KAAK,CAAC,SAAS,CAAC;SAChB,QAAQ,CACP,qGAAqG,CACtG;CACJ,CAAC;KACD,QAAQ,CACP,0FAA0F,CAC3F,CAAC;AAKJ;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAChD,CAAC"}

package/dist/remote.d.ts

@@ -126,8 +126,8 @@ export declare const CustomAddressStatusSchema: z.ZodEnum<{
 /** Where a custom hostname`s certificate is. */
 export declare const CertificateStateSchema: z.ZodEnum<{
     none: "none";
-    pending: "pending";
     failed: "failed";
+    pending: "pending";
     issued: "issued";
     renewing: "renewing";
 }>;
@@ -147,8 +147,8 @@ export declare const RemoteCustomAddressSchema: z.ZodObject<{
     certificate: z.ZodObject<{
         state: z.ZodEnum<{
             none: "none";
-            pending: "pending";
             failed: "failed";
+            pending: "pending";
             issued: "issued";
             renewing: "renewing";
         }>;

package/dist/routes.d.ts

@@ -50,6 +50,9 @@ export declare const V1_ROUTES: {
     readonly remoteCommands: "/v1/remote/commands";
     readonly remoteCommandsAck: "/v1/remote/commands/ack";
     readonly remoteEvents: "/v1/remote/events";
+    readonly communities: "/v1/communities";
+    readonly communitiesNameCheck: "/v1/communities/name-check";
+    readonly communitiesMoves: "/v1/communities/moves";
 };
 /** One of the fixed `/v1` paths. */
 export type V1Route = (typeof V1_ROUTES)[keyof typeof V1_ROUTES];
@@ -270,5 +273,45 @@ export declare const v1Path: {
      * @param addressId - The address's opaque identifier.
      */
     readonly address: (addressId: string) => string;
+    /**
+     * The route that issues a fresh owner-claim link for one hosted community,
+     * answered with `CommunityClaimLinkSchema`. Only while the community is
+     * `pending_owner`, and refused with `conflict` otherwise; the previous link
+     * stops working.
+     *
+     * @param communityId - The community's permanent identifier.
+     */
+    readonly communityClaimLink: (communityId: string) => string;
+    /**
+     * The route that keeps one hosted community open. Takes
+     * `CommunityKeepRequestSchema` and answers with `CommunityKeepResponseSchema`;
+     * a stale `expectedHeldCommunityIds` is refused with `conflict`.
+     *
+     * @param communityId - The community's permanent identifier.
+     */
+    readonly communityKeep: (communityId: string) => string;
+    /**
+     * The route that reopens one held community, answered with
+     * `HostedCommunitySchema`. It never puts another community on hold: a
+     * community that does not fit is refused with `entitlement_required`, and a
+     * hold the host placed with `forbidden`.
+     *
+     * @param communityId - The community's permanent identifier.
+     */
+    readonly communityRestore: (communityId: string) => string;
+    /**
+     * The route for one move, answered with `CommunityMoveSchema`.
+     *
+     * @param moveId - The move's opaque identifier.
+     */
+    readonly communityMove: (moveId: string) => string;
+    /**
+     * The route that cancels one move, answered with `CommunityMoveSchema`.
+     * Allowed until the move is `ready`, and refused with `conflict` after that.
+     * Cancelling removes the new community and everything uploaded for it.
+     *
+     * @param moveId - The move's opaque identifier.
+     */
+    readonly communityMoveCancel: (moveId: string) => string;
 };
 //# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mDAAmD;AACnD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CZ,CAAC;AAEX,oCAAoC;AACpC,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEjE;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM;IACjB;;;;OAIG;wCACwB,MAAM;IACjC;;;;OAIG;6CAC6B,MAAM;IACtC;;;;OAIG;uCACuB,MAAM;IAChC;;;;OAIG;0CAC0B,MAAM;IACnC;;;;OAIG;sCACsB,MAAM;IAC/B;;;;OAIG;0CAC0B,MAAM;IACnC;;;;OAIG;2CAC2B,MAAM;IACpC;;;;OAIG;oCACoB,MAAM;IAC7B;;;;OAIG;uCACuB,MAAM;IAChC;;;;OAIG;6CAC6B,MAAM;IACtC;;;;OAIG;0BACU,MAAM;IACnB;;;;OAIG;iCACiB,MAAM;IAC1B;;;;;OAKG;gCACgB,MAAM,YAAY,MAAM;IAC3C;;;;OAIG;qCACqB,MAAM;IAC9B;;;;;OAKG;oCACoB,MAAM,gBAAgB,MAAM;IAEnD;;;;OAIG;8CAC8B,MAAM;IACvC;;;;OAIG;+BACe,MAAM;IACxB;;;;OAIG;gCACgB,MAAM;IACzB;;;;OAIG;2CAC2B,MAAM;IACpC;;;;OAIG;8BACc,MAAM;IACvB;;;;;OAKG;0CAC0B,MAAM,WAAW,MAAM;IAEpD;;;;OAIG;4BACY,MAAM;IACrB;;;;OAIG;kCACkB,MAAM;IAC3B;;;;OAIG;mCACmB,MAAM;IAC5B;;;;OAIG;kCACkB,MAAM;IAC3B;;;;OAIG;mCACmB,MAAM;IAC5B;;;;OAIG;kCACkB,MAAM;IAC3B;;;;OAIG;kCACkB,MAAM;IAC3B;;;;;OAKG;iCACiB,MAAM,QAAQ,MAAM;IACxC;;;;OAIG;iCACiB,MAAM;IAC1B;;;;OAIG;qCACqB,MAAM;IAC9B;;;;OAIG;oCACoB,MAAM;IAC7B;;;;OAIG;oCACoB,MAAM;IAC7B;;;;OAIG;kCACkB,MAAM;CACnB,CAAC"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,mDAAmD;AACnD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CZ,CAAC;AAEX,oCAAoC;AACpC,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEjE;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM;IACjB;;;;OAIG;wCACwB,MAAM;IACjC;;;;OAIG;6CAC6B,MAAM;IACtC;;;;OAIG;uCACuB,MAAM;IAChC;;;;OAIG;0CAC0B,MAAM;IACnC;;;;OAIG;sCACsB,MAAM;IAC/B;;;;OAIG;0CAC0B,MAAM;IACnC;;;;OAIG;2CAC2B,MAAM;IACpC;;;;OAIG;oCACoB,MAAM;IAC7B;;;;OAIG;uCACuB,MAAM;IAChC;;;;OAIG;6CAC6B,MAAM;IACtC;;;;OAIG;0BACU,MAAM;IACnB;;;;OAIG;iCACiB,MAAM;IAC1B;;;;;OAKG;gCACgB,MAAM,YAAY,MAAM;IAC3C;;;;OAIG;qCACqB,MAAM;IAC9B;;;;;OAKG;oCACoB,MAAM,gBAAgB,MAAM;IAEnD;;;;OAIG;8CAC8B,MAAM;IACvC;;;;OAIG;+BACe,MAAM;IACxB;;;;OAIG;gCACgB,MAAM;IACzB;;;;OAIG;2CAC2B,MAAM;IACpC;;;;OAIG;8BACc,MAAM;IACvB;;;;;OAKG;0CAC0B,MAAM,WAAW,MAAM;IAEpD;;;;OAIG;4BACY,MAAM;IACrB;;;;OAIG;kCACkB,MAAM;IAC3B;;;;OAIG;mCACmB,MAAM;IAC5B;;;;OAIG;kCACkB,MAAM;IAC3B;;;;OAIG;mCACmB,MAAM;IAC5B;;;;OAIG;kCACkB,MAAM;IAC3B;;;;OAIG;kCACkB,MAAM;IAC3B;;;;;OAKG;iCACiB,MAAM,QAAQ,MAAM;IACxC;;;;OAIG;iCACiB,MAAM;IAC1B;;;;OAIG;qCACqB,MAAM;IAC9B;;;;OAIG;oCACoB,MAAM;IAC7B;;;;OAIG;oCACoB,MAAM;IAC7B;;;;OAIG;kCACkB,MAAM;IAC3B;;;;;;;OAOG;+CAC+B,MAAM;IAExC;;;;;;OAMG;0CAC0B,MAAM;IACnC;;;;;;;OAOG;6CAC6B,MAAM;IACtC;;;;OAIG;qCACqB,MAAM;IAC9B;;;;;;OAMG;2CAC2B,MAAM;CAC5B,CAAC"}

package/dist/routes.js

@@ -50,6 +50,9 @@ export const V1_ROUTES = {
     remoteCommands: '/v1/remote/commands',
     remoteCommandsAck: '/v1/remote/commands/ack',
     remoteEvents: '/v1/remote/events',
+    communities: '/v1/communities',
+    communitiesNameCheck: '/v1/communities/name-check',
+    communitiesMoves: '/v1/communities/moves',
 };
 /**
  * The `/v1` paths that take a path parameter, as builders.
@@ -268,7 +271,69 @@ export const v1Path = {
      * @param addressId - The address's opaque identifier.
      */
     address: (addressId) => `/v1/addresses/${enc(addressId)}`,
+    /**
+     * The route that issues a fresh owner-claim link for one hosted community,
+     * answered with `CommunityClaimLinkSchema`. Only while the community is
+     * `pending_owner`, and refused with `conflict` otherwise; the previous link
+     * stops working.
+     *
+     * @param communityId - The community's permanent identifier.
+     */
+    communityClaimLink: (communityId) => `/v1/communities/${communityEnc(communityId)}/claim-link`,
+    /**
+     * The route that keeps one hosted community open. Takes
+     * `CommunityKeepRequestSchema` and answers with `CommunityKeepResponseSchema`;
+     * a stale `expectedHeldCommunityIds` is refused with `conflict`.
+     *
+     * @param communityId - The community's permanent identifier.
+     */
+    communityKeep: (communityId) => `/v1/communities/${communityEnc(communityId)}/keep`,
+    /**
+     * The route that reopens one held community, answered with
+     * `HostedCommunitySchema`. It never puts another community on hold: a
+     * community that does not fit is refused with `entitlement_required`, and a
+     * hold the host placed with `forbidden`.
+     *
+     * @param communityId - The community's permanent identifier.
+     */
+    communityRestore: (communityId) => `/v1/communities/${communityEnc(communityId)}/restore`,
+    /**
+     * The route for one move, answered with `CommunityMoveSchema`.
+     *
+     * @param moveId - The move's opaque identifier.
+     */
+    communityMove: (moveId) => `/v1/communities/moves/${enc(moveId)}`,
+    /**
+     * The route that cancels one move, answered with `CommunityMoveSchema`.
+     * Allowed until the move is `ready`, and refused with `conflict` after that.
+     * Cancelling removes the new community and everything uploaded for it.
+     *
+     * @param moveId - The move's opaque identifier.
+     */
+    communityMoveCancel: (moveId) => `/v1/communities/moves/${enc(moveId)}/cancel`,
 };
+/**
+ * The fixed segments that sit where a community identifier would.
+ *
+ * `/v1/communities/moves` and `/v1/communities/name-check` share a prefix with
+ * `/v1/communities/{communityId}/…`, so a community identifier equal to one of
+ * them would build a path a router could read as the other route. The service
+ * issues opaque identifiers that are never these words, so one arriving here is
+ * a caller bug, refused like a dot segment.
+ */
+const COMMUNITY_FIXED_SEGMENTS = new Set(['moves', 'name-check']);
+/**
+ * Encodes a community identifier, refusing one that names a fixed route.
+ *
+ * @param communityId - The community's permanent identifier.
+ * @throws TypeError - When the identifier is a fixed segment, empty, or a dot segment.
+ */
+function communityEnc(communityId) {
+    if (COMMUNITY_FIXED_SEGMENTS.has(communityId)) {
+        throw new TypeError(`A community identifier must not be ${JSON.stringify(communityId)}; it names another route.`);
+    }
+    return enc(communityId);
+}
 /**
  * Encodes one opaque identifier for use as a single path segment.
  *

package/dist/routes.js.map

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

package/dist/seats.d.ts

@@ -202,8 +202,8 @@ export declare const SeatKindSchema: z.ZodEnum<{
 /** Where a seat is in its lifecycle. */
 export declare const SeatStatusSchema: z.ZodEnum<{
     assigned: "assigned";
-    unassigned: "unassigned";
     suspended: "suspended";
+    unassigned: "unassigned";
     released: "released";
 }>;
 /** Whether an address is live or has been retired. */
@@ -274,8 +274,8 @@ export declare const SeatSchema: z.ZodObject<{
     }>;
     status: z.ZodEnum<{
         assigned: "assigned";
-        unassigned: "unassigned";
         suspended: "suspended";
+        unassigned: "unassigned";
         released: "released";
     }>;
     subject: z.ZodNullable<z.ZodObject<{
@@ -315,8 +315,8 @@ export declare const SeatListResponseSchema: z.ZodObject<{
         }>;
         status: z.ZodEnum<{
             assigned: "assigned";
-            unassigned: "unassigned";
             suspended: "suspended";
+            unassigned: "unassigned";
             released: "released";
         }>;
         subject: z.ZodNullable<z.ZodObject<{
@@ -574,8 +574,8 @@ export declare const InboxBrowseResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 /** How reachable a seat is right now. */
 export declare const PresenceStateSchema: z.ZodEnum<{
-    active: "active";
     unknown: "unknown";
+    active: "active";
     offline: "offline";
     reachable: "reachable";
 }>;
@@ -583,8 +583,8 @@ export declare const PresenceStateSchema: z.ZodEnum<{
 export declare const PresenceSchema: z.ZodObject<{
     seatId: z.ZodString;
     state: z.ZodEnum<{
-        active: "active";
         unknown: "unknown";
+        active: "active";
         offline: "offline";
         reachable: "reachable";
     }>;

package/fixtures/v1/billing/entitlements-communities.json

@@ -0,0 +1,40 @@
+{
+  "planId": "pl_opaque_0000",
+  "planDisplayName": "the entitlement shown in your billing page",
+  "periodStart": "2026-09-15T12:00:00.000Z",
+  "periodEnd": "2026-10-15T12:00:00.000Z",
+  "limits": {
+    "personSeatsIncluded": 1,
+    "agentSeatsIncluded": 0,
+    "includedCreditsMicro": "0",
+    "cloudHours": 0,
+    "storageGb": 1,
+    "remoteAccess": "byo",
+    "alwaysAvailableInstances": 0,
+    "customAddress": "none",
+    "managedConnectionActions": null,
+    "support": "community",
+    "emailAddressPerSeat": false,
+    "communities": {
+      "maxCommunities": 3,
+      "maxMembersPerCommunity": 200,
+      "maxStorageBytesPerCommunity": 2000000000
+    }
+  },
+  "used": {
+    "personSeats": 1,
+    "agentSeats": 0,
+    "communities": 1
+  },
+  "seats": {
+    "total": 1,
+    "assigned": 1,
+    "byKind": {
+      "person": 1,
+      "agent": 0
+    }
+  },
+  "canCreateSeat": false,
+  "canInviteMember": false,
+  "staleAt": "2026-10-15T12:00:00.000Z"
+}

package/fixtures/v1/communities/claim-link.json

@@ -0,0 +1,5 @@
+{
+  "communityId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
+  "claimUrl": "https://community.example.invalid/claim/ct_opaque_0001",
+  "expiresAt": "2026-09-30T11:00:00.000Z"
+}

package/fixtures/v1/communities/keep-request.json

@@ -0,0 +1,3 @@
+{
+  "expectedHeldCommunityIds": ["4f1c2b7e-8a3d-4e5f-9b6a-1c2d3e4f5a6b"]
+}

package/fixtures/v1/communities/keep.json

@@ -0,0 +1,34 @@
+{
+  "community": {
+    "communityId": "2b3c4d5e-6f70-4812-9a3b-4c5d6e7f8091",
+    "orgId": "org_0001",
+    "name": "Reading group",
+    "shortName": "reading-group",
+    "communityUrl": "https://community.example.invalid/c/2b3c4d5e-6f70-4812-9a3b-4c5d6e7f8091",
+    "state": "active",
+    "hold": null,
+    "deletionAt": null,
+    "notice": null,
+    "kept": true,
+    "moveId": null,
+    "limits": {
+      "maxActiveMembers": 200,
+      "maxStorageBytes": 2000000000
+    },
+    "usage": {
+      "activeMembers": 12,
+      "storageBytes": 48213504,
+      "measuredAt": "2026-09-23T12:00:00.000Z"
+    },
+    "actions": {
+      "claimLink": false,
+      "keep": {
+        "allowed": false,
+        "wouldHold": []
+      },
+      "restore": false
+    },
+    "createdAt": "2025-06-01T09:00:00.000Z"
+  },
+  "heldCommunityIds": ["4f1c2b7e-8a3d-4e5f-9b6a-1c2d3e4f5a6b"]
+}