@censys/platform-sdk 0.10.0 → 0.10.1

package/src/models/components/sourceusagebreakdown.ts

@@ -16,11 +16,11 @@ export type SourceUsageBreakdown = {
   /**
    * The amount of credits consumed through auto-replenishment.
    */
-  autoReplenishment: number;
+  autoReplenishment?: number | undefined;
   /**
    * The amount of credits consumed through other operations.
    */
-  other: number;
+  other?: number | undefined;
   /**
    * The amount of credits consumed through the Platform UI.
    */
@@ -34,8 +34,8 @@ export const SourceUsageBreakdown$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   api: z.number().int(),
-  auto_replenishment: z.number().int(),
-  other: z.number().int(),
+  auto_replenishment: z.number().int().optional(),
+  other: z.number().int().optional(),
   ui: z.number().int(),
 }).transform((v) => {
   return remap$(v, {

package/src/models/components/stun.ts

@@ -0,0 +1,54 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  StunBindingErrorResponse,
+  StunBindingErrorResponse$inboundSchema,
+} from "./stunbindingerrorresponse.js";
+import {
+  StunBindingSuccessResponse,
+  StunBindingSuccessResponse$inboundSchema,
+} from "./stunbindingsuccessresponse.js";
+import { StunTurn, StunTurn$inboundSchema } from "./stunturn.js";
+
+export type Stun = {
+  bindingErrorResponse?: StunBindingErrorResponse | undefined;
+  bindingSuccessResponse?: StunBindingSuccessResponse | undefined;
+  responseType?: number | undefined;
+  responseTypeName?: string | undefined;
+  turn?: StunTurn | undefined;
+};
+
+/** @internal */
+export const Stun$inboundSchema: z.ZodType<Stun, z.ZodTypeDef, unknown> = z
+  .object({
+    binding_error_response: StunBindingErrorResponse$inboundSchema.optional(),
+    binding_success_response: StunBindingSuccessResponse$inboundSchema
+      .optional(),
+    response_type: z.number().int().optional(),
+    response_type_name: z.string().optional(),
+    turn: StunTurn$inboundSchema.optional(),
+  }).transform((v) => {
+    return remap$(v, {
+      "binding_error_response": "bindingErrorResponse",
+      "binding_success_response": "bindingSuccessResponse",
+      "response_type": "responseType",
+      "response_type_name": "responseTypeName",
+    });
+  });
+
+export function stunFromJSON(
+  jsonString: string,
+): SafeParseResult<Stun, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Stun$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Stun' from JSON`,
+  );
+}

package/src/models/components/stunbindingerrorresponse.ts

@@ -0,0 +1,44 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type StunBindingErrorResponse = {
+  errorCode?: number | undefined;
+  errorReason?: string | undefined;
+  hasFingerprint?: boolean | undefined;
+  software?: string | undefined;
+};
+
+/** @internal */
+export const StunBindingErrorResponse$inboundSchema: z.ZodType<
+  StunBindingErrorResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  error_code: z.number().int().optional(),
+  error_reason: z.string().optional(),
+  has_fingerprint: z.boolean().optional(),
+  software: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "error_code": "errorCode",
+    "error_reason": "errorReason",
+    "has_fingerprint": "hasFingerprint",
+  });
+});
+
+export function stunBindingErrorResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<StunBindingErrorResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StunBindingErrorResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StunBindingErrorResponse' from JSON`,
+  );
+}

package/src/models/components/stunbindingsuccessresponse.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  StunMappedAddress,
+  StunMappedAddress$inboundSchema,
+} from "./stunmappedaddress.js";
+
+export type StunBindingSuccessResponse = {
+  hasFingerprint?: boolean | undefined;
+  otherAddress?: StunMappedAddress | undefined;
+  software?: string | undefined;
+};
+
+/** @internal */
+export const StunBindingSuccessResponse$inboundSchema: z.ZodType<
+  StunBindingSuccessResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  has_fingerprint: z.boolean().optional(),
+  other_address: StunMappedAddress$inboundSchema.optional(),
+  software: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "has_fingerprint": "hasFingerprint",
+    "other_address": "otherAddress",
+  });
+});
+
+export function stunBindingSuccessResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<StunBindingSuccessResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StunBindingSuccessResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StunBindingSuccessResponse' from JSON`,
+  );
+}

package/src/models/components/stunmappedaddress.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type StunMappedAddress = {
+  ip?: string | undefined;
+  port?: number | undefined;
+};
+
+/** @internal */
+export const StunMappedAddress$inboundSchema: z.ZodType<
+  StunMappedAddress,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  ip: z.string().optional(),
+  port: z.number().int().optional(),
+});
+
+export function stunMappedAddressFromJSON(
+  jsonString: string,
+): SafeParseResult<StunMappedAddress, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StunMappedAddress$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StunMappedAddress' from JSON`,
+  );
+}

package/src/models/components/stunturn.ts

@@ -0,0 +1,55 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  StunTurnAllocateErrorResponse,
+  StunTurnAllocateErrorResponse$inboundSchema,
+} from "./stunturnallocateerrorresponse.js";
+import {
+  StunTurnAllocateSuccessResponse,
+  StunTurnAllocateSuccessResponse$inboundSchema,
+} from "./stunturnallocatesuccessresponse.js";
+
+export type StunTurn = {
+  allocateErrorResponse?: StunTurnAllocateErrorResponse | undefined;
+  allocateSuccessResponse?: StunTurnAllocateSuccessResponse | undefined;
+  responseType?: number | undefined;
+  responseTypeName?: string | undefined;
+};
+
+/** @internal */
+export const StunTurn$inboundSchema: z.ZodType<
+  StunTurn,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  allocate_error_response: StunTurnAllocateErrorResponse$inboundSchema
+    .optional(),
+  allocate_success_response: StunTurnAllocateSuccessResponse$inboundSchema
+    .optional(),
+  response_type: z.number().int().optional(),
+  response_type_name: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "allocate_error_response": "allocateErrorResponse",
+    "allocate_success_response": "allocateSuccessResponse",
+    "response_type": "responseType",
+    "response_type_name": "responseTypeName",
+  });
+});
+
+export function stunTurnFromJSON(
+  jsonString: string,
+): SafeParseResult<StunTurn, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StunTurn$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StunTurn' from JSON`,
+  );
+}

package/src/models/components/stunturnallocateerrorresponse.ts

@@ -0,0 +1,48 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type StunTurnAllocateErrorResponse = {
+  errorCode?: number | undefined;
+  errorReason?: string | undefined;
+  hasFingerprint?: boolean | undefined;
+  nonce?: string | undefined;
+  realm?: string | undefined;
+  software?: string | undefined;
+};
+
+/** @internal */
+export const StunTurnAllocateErrorResponse$inboundSchema: z.ZodType<
+  StunTurnAllocateErrorResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  error_code: z.number().int().optional(),
+  error_reason: z.string().optional(),
+  has_fingerprint: z.boolean().optional(),
+  nonce: z.string().optional(),
+  realm: z.string().optional(),
+  software: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "error_code": "errorCode",
+    "error_reason": "errorReason",
+    "has_fingerprint": "hasFingerprint",
+  });
+});
+
+export function stunTurnAllocateErrorResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<StunTurnAllocateErrorResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StunTurnAllocateErrorResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StunTurnAllocateErrorResponse' from JSON`,
+  );
+}

package/src/models/components/stunturnallocatesuccessresponse.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  StunMappedAddress,
+  StunMappedAddress$inboundSchema,
+} from "./stunmappedaddress.js";
+
+export type StunTurnAllocateSuccessResponse = {
+  hasFingerprint?: boolean | undefined;
+  relayAddress?: StunMappedAddress | undefined;
+  software?: string | undefined;
+};
+
+/** @internal */
+export const StunTurnAllocateSuccessResponse$inboundSchema: z.ZodType<
+  StunTurnAllocateSuccessResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  has_fingerprint: z.boolean().optional(),
+  relay_address: StunMappedAddress$inboundSchema.optional(),
+  software: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "has_fingerprint": "hasFingerprint",
+    "relay_address": "relayAddress",
+  });
+});
+
+export function stunTurnAllocateSuccessResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<StunTurnAllocateSuccessResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => StunTurnAllocateSuccessResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'StunTurnAllocateSuccessResponse' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -34,6 +34,7 @@ export * from "./v3globaldatascansrescan.js";
 export * from "./v3globaldatasearchaggregate.js";
 export * from "./v3globaldatasearchconvert.js";
 export * from "./v3globaldatasearchquery.js";
+export * from "./v3globaldataserviceonhost.js";
 export * from "./v3threathuntinggethostobservationswithcertificate.js";
 export * from "./v3threathuntingscansdiscovery.js";
 export * from "./v3threathuntingscansget.js";

package/src/models/operations/v3collectionscrudlist.ts

@@ -5,6 +5,7 @@
 import * as z from "zod/v3";
 import { remap as remap$ } from "../../lib/primitives.js";
 import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import * as components from "../components/index.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
@@ -13,6 +14,14 @@ export type V3CollectionsCrudListGlobals = {
   organizationId?: string | undefined;
 };
 
+export const CollectionStatuses = {
+  Populating: "populating",
+  Active: "active",
+  Paused: "paused",
+  Archived: "archived",
+} as const;
+export type CollectionStatuses = ClosedEnum<typeof CollectionStatuses>;
+
 export type V3CollectionsCrudListRequest = {
   /**
    * The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
@@ -26,6 +35,10 @@ export type V3CollectionsCrudListRequest = {
    * amount of results to return per page
    */
   pageSize?: number | undefined;
+  /**
+   * statuses of collection for results to be filtered on.
+   */
+  collectionStatuses?: Array<CollectionStatuses> | null | undefined;
 };
 
 export type V3CollectionsCrudListResponse = {
@@ -33,11 +46,17 @@ export type V3CollectionsCrudListResponse = {
   result: components.ResponseEnvelopeListCollectionsResponseV1;
 };
 
+/** @internal */
+export const CollectionStatuses$outboundSchema: z.ZodNativeEnum<
+  typeof CollectionStatuses
+> = z.nativeEnum(CollectionStatuses);
+
 /** @internal */
 export type V3CollectionsCrudListRequest$Outbound = {
   organization_id?: string | undefined;
   page_token?: string | undefined;
   page_size?: number | undefined;
+  collection_statuses?: Array<string> | null | undefined;
 };
 
 /** @internal */
@@ -49,11 +68,14 @@ export const V3CollectionsCrudListRequest$outboundSchema: z.ZodType<
   organizationId: z.string().optional(),
   pageToken: z.string().optional(),
   pageSize: z.number().int().optional(),
+  collectionStatuses: z.nullable(z.array(CollectionStatuses$outboundSchema))
+    .optional(),
 }).transform((v) => {
   return remap$(v, {
     organizationId: "organization_id",
     pageToken: "page_token",
     pageSize: "page_size",
+    collectionStatuses: "collection_statuses",
   });
 });
 

package/src/models/operations/v3globaldataserviceonhost.ts

@@ -0,0 +1,173 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type V3GlobaldataServiceOnHostGlobals = {
+  organizationId?: string | undefined;
+};
+
+/**
+ * Filter by transport protocol
+ */
+export const TransportProtocol = {
+  Tcp: "tcp",
+  Udp: "udp",
+  Quic: "quic",
+} as const;
+/**
+ * Filter by transport protocol
+ */
+export type TransportProtocol = ClosedEnum<typeof TransportProtocol>;
+
+export const OrderBy = {
+  PortASC: "port ASC",
+  PortDESC: "port DESC",
+  ProtocolASC: "protocol ASC",
+  ProtocolDESC: "protocol DESC",
+  TransportProtocolASC: "transport_protocol ASC",
+  TransportProtocolDESC: "transport_protocol DESC",
+} as const;
+export type OrderBy = ClosedEnum<typeof OrderBy>;
+
+export type V3GlobaldataServiceOnHostRequest = {
+  /**
+   * The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information.
+   */
+  organizationId?: string | undefined;
+  /**
+   * Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time.
+   */
+  startTime?: string | undefined;
+  /**
+   * End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.
+   */
+  endTime?: string | undefined;
+  /**
+   * Number of results per page (max 100)
+   */
+  pageSize?: number | undefined;
+  /**
+   * Pagination token from previous response
+   */
+  pageToken?: string | undefined;
+  /**
+   * Filter by port number
+   */
+  port?: number | undefined;
+  /**
+   * Filter by application protocol
+   */
+  protocol?: string | undefined;
+  /**
+   * Filter by transport protocol
+   */
+  transportProtocol?: TransportProtocol | undefined;
+  /**
+   * The IP address of a host.
+   */
+  hostId: string;
+  /**
+   * Order observations by these fields. Multiple values can be provided to sort by multiple fields (e.g., ['port DESC', 'protocol ASC']).
+   */
+  orderBy?: Array<OrderBy> | null | undefined;
+};
+
+export type V3GlobaldataServiceOnHostResponse = {
+  headers: { [k: string]: Array<string> };
+  result: components.ResponseEnvelopeServicesOnHostResponse;
+};
+
+/** @internal */
+export const TransportProtocol$outboundSchema: z.ZodNativeEnum<
+  typeof TransportProtocol
+> = z.nativeEnum(TransportProtocol);
+
+/** @internal */
+export const OrderBy$outboundSchema: z.ZodNativeEnum<typeof OrderBy> = z
+  .nativeEnum(OrderBy);
+
+/** @internal */
+export type V3GlobaldataServiceOnHostRequest$Outbound = {
+  organization_id?: string | undefined;
+  start_time?: string | undefined;
+  end_time?: string | undefined;
+  page_size: number;
+  page_token?: string | undefined;
+  port?: number | undefined;
+  protocol?: string | undefined;
+  transport_protocol?: string | undefined;
+  host_id: string;
+  order_by?: Array<string> | null | undefined;
+};
+
+/** @internal */
+export const V3GlobaldataServiceOnHostRequest$outboundSchema: z.ZodType<
+  V3GlobaldataServiceOnHostRequest$Outbound,
+  z.ZodTypeDef,
+  V3GlobaldataServiceOnHostRequest
+> = z.object({
+  organizationId: z.string().optional(),
+  startTime: z.string().optional(),
+  endTime: z.string().optional(),
+  pageSize: z.number().int().default(100),
+  pageToken: z.string().optional(),
+  port: z.number().int().optional(),
+  protocol: z.string().optional(),
+  transportProtocol: TransportProtocol$outboundSchema.optional(),
+  hostId: z.string(),
+  orderBy: z.nullable(z.array(OrderBy$outboundSchema)).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    organizationId: "organization_id",
+    startTime: "start_time",
+    endTime: "end_time",
+    pageSize: "page_size",
+    pageToken: "page_token",
+    transportProtocol: "transport_protocol",
+    hostId: "host_id",
+    orderBy: "order_by",
+  });
+});
+
+export function v3GlobaldataServiceOnHostRequestToJSON(
+  v3GlobaldataServiceOnHostRequest: V3GlobaldataServiceOnHostRequest,
+): string {
+  return JSON.stringify(
+    V3GlobaldataServiceOnHostRequest$outboundSchema.parse(
+      v3GlobaldataServiceOnHostRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const V3GlobaldataServiceOnHostResponse$inboundSchema: z.ZodType<
+  V3GlobaldataServiceOnHostResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  Headers: z.record(z.array(z.string())).default({}),
+  Result: components.ResponseEnvelopeServicesOnHostResponse$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "Headers": "headers",
+    "Result": "result",
+  });
+});
+
+export function v3GlobaldataServiceOnHostResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<V3GlobaldataServiceOnHostResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => V3GlobaldataServiceOnHostResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'V3GlobaldataServiceOnHostResponse' from JSON`,
+  );
+}

package/src/sdk/globaldata.ts

@@ -15,6 +15,7 @@ import { globalDataGetHostTimeline } from "../funcs/globalDataGetHostTimeline.js
 import { globalDataGetTrackedScan } from "../funcs/globalDataGetTrackedScan.js";
 import { globalDataGetWebProperties } from "../funcs/globalDataGetWebProperties.js";
 import { globalDataGetWebProperty } from "../funcs/globalDataGetWebProperty.js";
+import { globalDataListServicesOnHost } from "../funcs/globalDataListServicesOnHost.js";
 import { globalDataSearch } from "../funcs/globalDataSearch.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as operations from "../models/operations/index.js";
@@ -123,6 +124,23 @@ export class GlobalData extends ClientSDK {
     ));
   }
 
+  /**
+   * Get service history for a host
+   *
+   * @remarks
+   * Retrieve historical service observations for a host. This endpoint returns time ranges during which services were detected on the host.<br><br>You can define a specific time frame of interest. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account.<br><br>You can filter by port number, protocol, and transport protocol.
+   */
+  async listServicesOnHost(
+    request: operations.V3GlobaldataServiceOnHostRequest,
+    options?: RequestOptions,
+  ): Promise<operations.V3GlobaldataServiceOnHostResponse> {
+    return unwrapAsync(globalDataListServicesOnHost(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Get host event history
    *