@goable-io/sdk 0.2.0 → 0.4.0

package/src/index.ts

@@ -12,6 +12,7 @@
 export { GoableClient } from "./client.ts"
 export type { FetchLike, GoableClientOptions } from "./client.ts"
 export {
+  DriftActiveError,
   GoableApiError,
   GoableNetworkError,
   type ZodIssueLike,

package/src/types.ts

@@ -11,13 +11,33 @@
 import type { components, paths } from "./generated/api.ts"
 
 // ── helpers ────────────────────────────────────────────────────────────
-type JsonOf<T> = T extends { content: { "application/json": infer B } } ? B : never
-/** application/json request body of an operation. */
-type ReqOf<O> = O extends { requestBody?: infer RB } ? JsonOf<NonNullable<RB>> : never
-/** application/json body of a response status code. */
-type ResOf<O, C extends number> = O extends { responses: infer R } ? (C extends keyof R ? JsonOf<R[C]> : never) : never
-
+/** The sole media body of a request/response, whatever the media type
+ *  (application/json, application/ld+json, or application/x-ndjson → string). */
+type ContentOf<T> = T extends { content: infer C } ? C[keyof C] : never
+/** Request body of an operation. */
+type ReqOf<O> = O extends { requestBody?: infer RB } ? ContentOf<NonNullable<RB>> : never
+/** Response body for a specific status code. */
+type ResOf<O, C extends number> = O extends { responses: infer R }
+  ? C extends keyof R
+    ? ContentOf<R[C]>
+    : never
+  : never
+/** The 2xx success body — the first of 200 / 201 / 202 the operation declares. */
+type OkOf<O> = O extends { responses: infer R }
+  ? 200 extends keyof R
+    ? ContentOf<R[200]>
+    : 201 extends keyof R
+      ? ContentOf<R[201]>
+      : 202 extends keyof R
+        ? ContentOf<R[202]>
+        : never
+  : never
+/** The query-parameter object of an operation. */
+type QueryOf<O> = O extends { parameters: { query?: infer Q } } ? NonNullable<Q> : never
+
+type Get<P extends keyof paths> = paths[P] extends { get: infer O } ? O : never
 type Post<P extends keyof paths> = paths[P] extends { post: infer O } ? O : never
+type Patch<P extends keyof paths> = paths[P] extends { patch: infer O } ? O : never
 
 // ── shared primitives (from components) ───────────────────────────────────
 export type GeoPoint = components["schemas"]["GeoPoint"]
@@ -61,6 +81,84 @@ export type QuoteResponse = ResOf<Post<"/v1/underwriting/quote">, 200>
 export type RecommendSpotRequest = ReqOf<Post<"/v1/recommend-spot">>
 export type RecommendSpotResponse = ResOf<Post<"/v1/recommend-spot">, 200>
 
+export type ScoreDifficultyRequest = ReqOf<Post<"/v1/score/difficulty">>
+export type ScoreDifficultyResponse = OkOf<Post<"/v1/score/difficulty">>
+
+export type ReportOutcomeRequest = ReqOf<Post<"/v1/score/{sessionId}/outcome">>
+export type ReportOutcomeResponse = OkOf<Post<"/v1/score/{sessionId}/outcome">>
+
+export type EdgeCaseRequest = ReqOf<Post<"/v1/intelligence/edge-case">>
+export type EdgeCaseResponse = OkOf<Post<"/v1/intelligence/edge-case">>
+
+export type ProjectionsPortfolioRequest = ReqOf<Post<"/v1/projections/portfolio">>
+export type ProjectionsPortfolioResponse = OkOf<Post<"/v1/projections/portfolio">>
+
+export type AdaptationReportRequest = ReqOf<Post<"/v1/projections/adaptation-report">>
+export type AdaptationReportResponse = OkOf<Post<"/v1/projections/adaptation-report">>
+
+// ── underwriting policy lifecycle ─────────────────────────────────────────
+export type QuoteByIdResponse = OkOf<Get<"/v1/underwriting/quote/{id}">>
+
+export type BindPolicyRequest = ReqOf<Post<"/v1/underwriting/policy/bind">>
+export type BindPolicyResponse = OkOf<Post<"/v1/underwriting/policy/bind">>
+
+export type ListPoliciesQuery = QueryOf<Get<"/v1/underwriting/policy">>
+export type ListPoliciesResponse = OkOf<Get<"/v1/underwriting/policy">>
+
+export type PolicyResponse = OkOf<Get<"/v1/underwriting/policy/{policyId}">>
+
+export type EvaluatePolicyResponse = OkOf<Post<"/v1/underwriting/policy/{policyId}/evaluate">>
+
+export type SettlePolicyRequest = ReqOf<Post<"/v1/underwriting/policy/{policyId}/settle">>
+export type SettlePolicyResponse = OkOf<Post<"/v1/underwriting/policy/{policyId}/settle">>
+
+/** Serialised parametric policy record + payout event, reused across the lifecycle. */
+export type SerialisedPolicy = components["schemas"]["SerialisedPolicy"]
+export type SerialisedPayoutEvent = components["schemas"]["SerialisedPayoutEvent"]
+
+// ── observations (L5.3) ───────────────────────────────────────────────────
+export type CreateStationRequest = ReqOf<Post<"/v1/observations/stations">>
+export type CreateStationResponse = OkOf<Post<"/v1/observations/stations">>
+
+export type ListStationsResponse = OkOf<Get<"/v1/observations/stations">>
+
+export type UpdateStationRequest = ReqOf<Patch<"/v1/observations/stations/{stationId}">>
+export type UpdateStationResponse = OkOf<Patch<"/v1/observations/stations/{stationId}">>
+
+export type SubmitObservationsRequest = ReqOf<Post<"/v1/observations">>
+export type SubmitObservationsResponse = OkOf<Post<"/v1/observations">>
+
+export type RecentObservationsQuery = QueryOf<Get<"/v1/observations/stations/{stationId}/recent">>
+export type RecentObservationsResponse = OkOf<Get<"/v1/observations/stations/{stationId}/recent">>
+
+// ── public / research (no-auth) ───────────────────────────────────────────
+export type SustainabilityIndexQuery = QueryOf<Get<"/v1/public/sustainability-index">>
+export type SustainabilityIndexResponse = OkOf<Get<"/v1/public/sustainability-index">>
+
+export type VerificationExportQuery = QueryOf<Get<"/v1/research/verification/export">>
+
+export type PublicSignupRequest = ReqOf<Post<"/v1/public/signup">>
+export type PublicSignupResponse = OkOf<Post<"/v1/public/signup">>
+
+export type CatalogStatsResponse = OkOf<Get<"/v1/public/catalog-stats">>
+
+// ── webhooks ──────────────────────────────────────────────────────────────
+/** Every webhook event the platform can deliver (from the OpenAPI enum). */
+export type WebhookEventType = components["schemas"]["WebhookEvent"]
+
+/**
+ * A webhook delivery body, POSTed to a tenant's registered endpoint. The
+ * envelope shape is stable; `data` is per-event and best-effort — narrow it
+ * with `if (delivery.type === "underwriting.policy.bound") { ... }`. Field
+ * names mirror the deliverer exactly (`id` / `type` / `created`).
+ */
+export interface WebhookDelivery<T = Record<string, unknown>> {
+  id: string
+  type: WebhookEventType
+  created: string
+  data: T
+}
+
 export type HealthResponse = ResOf<paths["/v1/health"] extends { get: infer O } ? O : never, 200>
 
 // ── SDK-specific result types (not wire schemas) ─────────────────────────