@censys/platform-sdk 0.10.1 → 0.10.3

package/src/lib/files.ts

@@ -80,3 +80,25 @@ export function getContentTypeFromFileName(fileName: string): string | null {
 
   return mimeTypes[ext] || null;
 }
+
+/**
+ * Creates a Blob from file content with the given MIME type.
+ *
+ * Node.js Buffers are Uint8Array subclasses that may share a pooled
+ * ArrayBuffer (byteOffset > 0, byteLength < buffer.byteLength). Passing
+ * such a Buffer directly to `new Blob([buf])` can include the entire
+ * underlying pool on some runtimes, producing a Blob with extra bytes
+ * that corrupts multipart uploads.
+ *
+ * Copying into a standalone Uint8Array ensures the Blob receives only the
+ * intended bytes regardless of runtime behaviour.
+ */
+export function bytesToBlob(
+  content: Uint8Array<ArrayBufferLike> | ArrayBuffer | Blob | string,
+  contentType: string,
+): Blob {
+  if (content instanceof Uint8Array) {
+    return new Blob([new Uint8Array(content)], { type: contentType });
+  }
+  return new Blob([content as BlobPart], { type: contentType });
+}

package/src/lib/matchers.ts

@@ -248,8 +248,9 @@ export function match<T, E>(
         raw = body;
         break;
       default:
-        encoding satisfies never;
-        throw new Error(`Unsupported response type: ${encoding}`);
+        throw new Error(
+          `Unsupported response type: ${encoding satisfies never}`,
+        );
     }
 
     if (matcher.enc === "fail") {

package/src/lib/sdks.ts

@@ -124,13 +124,15 @@ export class ClientSDK {
     if (!base) {
       return ERR(new InvalidRequestError("No base URL provided for operation"));
     }
-    const reqURL = new URL(base);
-    const inputURL = new URL(path, reqURL);
-
+    const baseURL = new URL(base);
+    let reqURL: URL;
     if (path) {
-      reqURL.pathname += reqURL.pathname.endsWith("/") ? "" : "/";
-      reqURL.pathname += inputURL.pathname.replace(/^\/+/, "");
+      baseURL.pathname = baseURL.pathname.replace(/\/+$/, "") + "/";
+      reqURL = new URL(path, baseURL);
+    } else {
+      reqURL = baseURL;
     }
+    reqURL.hash = "";
 
     let finalQuery = query || "";
 

package/src/lib/security.ts

@@ -197,8 +197,7 @@ export function resolveSecurity(
         applyBearer(state, spec);
         break;
       default:
-        spec satisfies never;
-        throw SecurityError.unrecognizedType(type);
+        throw SecurityError.unrecognizedType((spec satisfies never, type));
     }
   });
 
@@ -240,8 +239,9 @@ function applyBearer(
 
 export function resolveGlobalSecurity(
   security: Partial<components.Security> | null | undefined,
+  allowedFields?: number[],
 ): SecurityState | null {
-  return resolveSecurity(
+  let inputs: SecurityInput[][] = [
     [
       {
         fieldName: "Authorization",
@@ -249,7 +249,18 @@ export function resolveGlobalSecurity(
         value: security?.personalAccessToken,
       },
     ],
-  );
+  ];
+
+  if (allowedFields) {
+    inputs = allowedFields.map((i) => {
+      if (i < 0 || i >= inputs.length) {
+        throw new RangeError(`invalid allowedFields index ${i}`);
+      }
+      return inputs[i]!;
+    });
+  }
+
+  return resolveSecurity(...inputs);
 }
 
 export async function extractSecurity<

package/src/lib/url.ts

@@ -13,21 +13,23 @@ export function pathToFunc(
   const paramRE = /\{([a-zA-Z0-9_][a-zA-Z0-9_-]*?)\}/g;
 
   return function buildURLPath(params: Record<string, unknown> = {}): string {
-    return pathPattern.replace(paramRE, function (_, placeholder) {
-      if (!hasOwn.call(params, placeholder)) {
-        throw new Error(`Parameter '${placeholder}' is required`);
-      }
+    return pathPattern
+      .replace(paramRE, function (_, placeholder) {
+        if (!hasOwn.call(params, placeholder)) {
+          throw new Error(`Parameter '${placeholder}' is required`);
+        }
 
-      const value = params[placeholder];
-      if (typeof value !== "string" && typeof value !== "number") {
-        throw new Error(
-          `Parameter '${placeholder}' must be a string or number`,
-        );
-      }
+        const value = params[placeholder];
+        if (typeof value !== "string" && typeof value !== "number") {
+          throw new Error(
+            `Parameter '${placeholder}' must be a string or number`,
+          );
+        }
 
-      return options?.charEncoding === "percent"
-        ? encodeURIComponent(`${value}`)
-        : `${value}`;
-    });
+        return options?.charEncoding === "percent"
+          ? encodeURIComponent(`${value}`)
+          : `${value}`;
+      })
+      .replace(/^\/+/, "");
   };
 }

package/src/models/components/censeyejob.ts

@@ -0,0 +1,106 @@
+/*
+ * 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 * as openEnums from "../../types/enums.js";
+import { OpenEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { CenseyeTarget, CenseyeTarget$inboundSchema } from "./censeyetarget.js";
+
+/**
+ * Current state of the job.
+ */
+export const State = {
+  Started: "started",
+  Completed: "completed",
+  Failed: "failed",
+  Unknown: "unknown",
+} as const;
+/**
+ * Current state of the job.
+ */
+export type State = OpenEnum<typeof State>;
+
+export type CenseyeJob = {
+  /**
+   * The point-in-time the asset data was evaluated at.
+   */
+  atTime?: Date | undefined;
+  /**
+   * When the job was created.
+   */
+  createTime?: Date | undefined;
+  /**
+   * When the job and results will be deleted.
+   */
+  deleteTime?: Date | undefined;
+  /**
+   * Error message if the job failed.
+   */
+  error?: string | undefined;
+  /**
+   * Unique identifier of the job.
+   */
+  jobId: string;
+  /**
+   * Total number of result field-value pairs.
+   */
+  resultCount?: number | undefined;
+  /**
+   * Current state of the job.
+   */
+  state: State;
+  target: CenseyeTarget;
+  /**
+   * When the job was last updated.
+   */
+  updateTime?: Date | undefined;
+};
+
+/** @internal */
+export const State$inboundSchema: z.ZodType<State, z.ZodTypeDef, unknown> =
+  openEnums.inboundSchema(State);
+
+/** @internal */
+export const CenseyeJob$inboundSchema: z.ZodType<
+  CenseyeJob,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  at_time: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  create_time: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  delete_time: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  error: z.string().optional(),
+  job_id: z.string(),
+  result_count: z.number().int().optional(),
+  state: State$inboundSchema,
+  target: CenseyeTarget$inboundSchema,
+  update_time: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "at_time": "atTime",
+    "create_time": "createTime",
+    "delete_time": "deleteTime",
+    "job_id": "jobId",
+    "result_count": "resultCount",
+    "update_time": "updateTime",
+  });
+});
+
+export function censeyeJobFromJSON(
+  jsonString: string,
+): SafeParseResult<CenseyeJob, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CenseyeJob$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CenseyeJob' from JSON`,
+  );
+}

package/src/models/components/censeyeresult.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";
+import {
+  FieldValuePair,
+  FieldValuePair$inboundSchema,
+} from "./fieldvaluepair.js";
+
+export type CenseyeResult = {
+  /**
+   * Number of matching documents for this field-value combination.
+   */
+  count: number;
+  /**
+   * The field-value pairs that were counted.
+   */
+  fieldValuePairs: Array<FieldValuePair> | null;
+};
+
+/** @internal */
+export const CenseyeResult$inboundSchema: z.ZodType<
+  CenseyeResult,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  count: z.number(),
+  field_value_pairs: z.nullable(z.array(FieldValuePair$inboundSchema)),
+}).transform((v) => {
+  return remap$(v, {
+    "field_value_pairs": "fieldValuePairs",
+  });
+});
+
+export function censeyeResultFromJSON(
+  jsonString: string,
+): SafeParseResult<CenseyeResult, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CenseyeResult$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CenseyeResult' from JSON`,
+  );
+}

package/src/models/components/censeyeresultsresponse.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 { CenseyeResult, CenseyeResult$inboundSchema } from "./censeyeresult.js";
+
+export type CenseyeResultsResponse = {
+  /**
+   * Token to retrieve the next page of results.
+   */
+  nextPageToken?: string | undefined;
+  /**
+   * List of count results.
+   */
+  results: Array<CenseyeResult> | null;
+};
+
+/** @internal */
+export const CenseyeResultsResponse$inboundSchema: z.ZodType<
+  CenseyeResultsResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  next_page_token: z.string().optional(),
+  results: z.nullable(z.array(CenseyeResult$inboundSchema)),
+}).transform((v) => {
+  return remap$(v, {
+    "next_page_token": "nextPageToken",
+  });
+});
+
+export function censeyeResultsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<CenseyeResultsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CenseyeResultsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CenseyeResultsResponse' from JSON`,
+  );
+}

package/src/models/components/censeyetarget.ts

@@ -0,0 +1,77 @@
+/*
+ * 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 CenseyeTarget = {
+  /**
+   * SHA-256 fingerprint of the certificate to analyze.
+   */
+  certificateId?: string | undefined;
+  /**
+   * IP address of the host to analyze.
+   */
+  hostId?: string | undefined;
+  /**
+   * Web property identifier (hostname:port) to analyze.
+   */
+  webpropertyId?: string | undefined;
+};
+
+/** @internal */
+export const CenseyeTarget$inboundSchema: z.ZodType<
+  CenseyeTarget,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  certificate_id: z.string().optional(),
+  host_id: z.string().optional(),
+  webproperty_id: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "certificate_id": "certificateId",
+    "host_id": "hostId",
+    "webproperty_id": "webpropertyId",
+  });
+});
+/** @internal */
+export type CenseyeTarget$Outbound = {
+  certificate_id?: string | undefined;
+  host_id?: string | undefined;
+  webproperty_id?: string | undefined;
+};
+
+/** @internal */
+export const CenseyeTarget$outboundSchema: z.ZodType<
+  CenseyeTarget$Outbound,
+  z.ZodTypeDef,
+  CenseyeTarget
+> = z.object({
+  certificateId: z.string().optional(),
+  hostId: z.string().optional(),
+  webpropertyId: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    certificateId: "certificate_id",
+    hostId: "host_id",
+    webpropertyId: "webproperty_id",
+  });
+});
+
+export function censeyeTargetToJSON(censeyeTarget: CenseyeTarget): string {
+  return JSON.stringify(CenseyeTarget$outboundSchema.parse(censeyeTarget));
+}
+export function censeyeTargetFromJSON(
+  jsonString: string,
+): SafeParseResult<CenseyeTarget, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CenseyeTarget$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CenseyeTarget' from JSON`,
+  );
+}

package/src/models/components/countcondition.ts

@@ -12,7 +12,7 @@ import {
 
 export type CountCondition = {
   /**
-   * Field-value pairs to count matches for. Must target fields from the same nested object.
+   * Field-value pairs to count matches for. Must target fields from the same nested object and may contain at most 5 pairs per group.
    */
   fieldValuePairs: Array<FieldValuePair> | null;
 };

package/src/models/components/createcenseyejobinputbody.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import {
+  CenseyeTarget,
+  CenseyeTarget$Outbound,
+  CenseyeTarget$outboundSchema,
+} from "./censeyetarget.js";
+
+export type CreateCenseyeJobInputBody = {
+  target: CenseyeTarget;
+};
+
+/** @internal */
+export type CreateCenseyeJobInputBody$Outbound = {
+  target: CenseyeTarget$Outbound;
+};
+
+/** @internal */
+export const CreateCenseyeJobInputBody$outboundSchema: z.ZodType<
+  CreateCenseyeJobInputBody$Outbound,
+  z.ZodTypeDef,
+  CreateCenseyeJobInputBody
+> = z.object({
+  target: CenseyeTarget$outboundSchema,
+});
+
+export function createCenseyeJobInputBodyToJSON(
+  createCenseyeJobInputBody: CreateCenseyeJobInputBody,
+): string {
+  return JSON.stringify(
+    CreateCenseyeJobInputBody$outboundSchema.parse(createCenseyeJobInputBody),
+  );
+}

package/src/models/components/fieldvaluepair.ts

@@ -3,6 +3,9 @@
  */
 
 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 FieldValuePair = {
   /**
@@ -15,6 +18,15 @@ export type FieldValuePair = {
   value: string;
 };
 
+/** @internal */
+export const FieldValuePair$inboundSchema: z.ZodType<
+  FieldValuePair,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  field: z.string(),
+  value: z.string(),
+});
 /** @internal */
 export type FieldValuePair$Outbound = {
   field: string;
@@ -34,3 +46,12 @@ export const FieldValuePair$outboundSchema: z.ZodType<
 export function fieldValuePairToJSON(fieldValuePair: FieldValuePair): string {
   return JSON.stringify(FieldValuePair$outboundSchema.parse(fieldValuePair));
 }
+export function fieldValuePairFromJSON(
+  jsonString: string,
+): SafeParseResult<FieldValuePair, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => FieldValuePair$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'FieldValuePair' from JSON`,
+  );
+}

package/src/models/components/host.ts

@@ -12,6 +12,12 @@ import { Greynoise, Greynoise$inboundSchema } from "./greynoise.js";
 import { HostDns, HostDns$inboundSchema } from "./hostdns.js";
 import { Label, Label$inboundSchema } from "./label.js";
 import { Location, Location$inboundSchema } from "./location.js";
+import {
+  NetworkClassification,
+  NetworkClassification$inboundSchema,
+} from "./networkclassification.js";
+import { Privacy, Privacy$inboundSchema } from "./privacy.js";
+import { Reputation, Reputation$inboundSchema } from "./reputation.js";
 import { Routing, Routing$inboundSchema } from "./routing.js";
 import { Service, Service$inboundSchema } from "./service.js";
 import { Whois, Whois$inboundSchema } from "./whois.js";
@@ -24,7 +30,16 @@ export type Host = {
   ip?: string | undefined;
   labels?: Array<Label> | null | undefined;
   location?: Location | undefined;
+  /**
+   * Information about what type of network the host belongs to.
+   */
+  network?: Array<NetworkClassification> | null | undefined;
   operatingSystem?: Attribute | undefined;
+  /**
+   * Information about privacy services used by the IP, such as VPNs, Proxies, or Tor.
+   */
+  privacy?: Array<Privacy> | null | undefined;
+  reputation?: Reputation | undefined;
   serviceCount?: number | undefined;
   services?: Array<Service> | null | undefined;
   whois?: Whois | undefined;
@@ -40,7 +55,11 @@ export const Host$inboundSchema: z.ZodType<Host, z.ZodTypeDef, unknown> = z
     ip: z.string().optional(),
     labels: z.nullable(z.array(Label$inboundSchema)).optional(),
     location: Location$inboundSchema.optional(),
+    network: z.nullable(z.array(NetworkClassification$inboundSchema))
+      .optional(),
     operating_system: Attribute$inboundSchema.optional(),
+    privacy: z.nullable(z.array(Privacy$inboundSchema)).optional(),
+    reputation: Reputation$inboundSchema.optional(),
     service_count: z.number().int().optional(),
     services: z.nullable(z.array(Service$inboundSchema)).optional(),
     whois: Whois$inboundSchema.optional(),

package/src/models/components/index.ts

@@ -24,6 +24,10 @@ export * from "./bacnet.js";
 export * from "./basicconstraints.js";
 export * from "./cabforganizationid.js";
 export * from "./capabilities.js";
+export * from "./censeyejob.js";
+export * from "./censeyeresult.js";
+export * from "./censeyeresultsresponse.js";
+export * from "./censeyetarget.js";
 export * from "./certificate.js";
 export * from "./certificateasset.js";
 export * from "./certificateextensions.js";
@@ -59,6 +63,7 @@ export * from "./coordinates.js";
 export * from "./countcondition.js";
 export * from "./cpe.js";
 export * from "./cpelifecycle.js";
+export * from "./createcenseyejobinputbody.js";
 export * from "./creditexpiration.js";
 export * from "./creditusagereport.js";
 export * from "./creditusagereportperiod.js";
@@ -299,8 +304,10 @@ export * from "./natsio.js";
 export * from "./nbd.js";
 export * from "./network.js";
 export * from "./networkcapabilities.js";
+export * from "./networkclassification.js";
 export * from "./networklog.js";
 export * from "./networklogresourceinfo.js";
+export * from "./networkmobileinfo.js";
 export * from "./nfsmountd.js";
 export * from "./nmea.js";
 export * from "./nmeanmeamessage.js";
@@ -356,6 +363,10 @@ export * from "./pprof.js";
 export * from "./pptp.js";
 export * from "./pptpresponseinfo.js";
 export * from "./pptpversion.js";
+export * from "./privacy.js";
+export * from "./privacytorinfo.js";
+export * from "./privacytorinforelay.js";
+export * from "./privacytorinforelayexitpolicysummary.js";
 export * from "./profinetcm.js";
 export * from "./prometheus.js";
 export * from "./prometheusmetricfamily.js";
@@ -392,6 +403,13 @@ export * from "./redlionweb.js";
 export * from "./reject.js";
 export * from "./replaycapabilities.js";
 export * from "./representativeinfo.js";
+export * from "./reputation.js";
+export * from "./reputationevidence.js";
+export * from "./reputationevidenceexternalsignal.js";
+export * from "./reputationevidencefieldvalue.js";
+export * from "./reputationevidencethreat.js";
+export * from "./responseenvelopecenseyejob.js";
+export * from "./responseenvelopecenseyeresultsresponse.js";
 export * from "./responseenvelopecertificateasset.js";
 export * from "./responseenvelopecollection.js";
 export * from "./responseenvelopecollectioneventsresponse.js";
@@ -444,6 +462,9 @@ export * from "./rustdeskrendezvousconfigupdate.js";
 export * from "./rustdeskrendezvouskeyexchange.js";
 export * from "./rustdeskrendezvoustestnatresponse.js";
 export * from "./s7.js";
+export * from "./sapient.js";
+export * from "./sapienterror.js";
+export * from "./sapientregistrationack.js";
 export * from "./saprouter.js";
 export * from "./saprouterclientinfo.js";
 export * from "./saprouterrouterinfo.js";

package/src/models/components/networkclassification.ts

@@ -0,0 +1,60 @@
+/*
+ * 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 {
+  NetworkMobileInfo,
+  NetworkMobileInfo$inboundSchema,
+} from "./networkmobileinfo.js";
+
+export type NetworkClassification = {
+  /**
+   * Whether the host belongs to an Internet hosting service provider.
+   */
+  hosting?: boolean | undefined;
+  /**
+   * Whether the host belongs to a mobile network.
+   */
+  mobile?: boolean | undefined;
+  mobileInfo?: NetworkMobileInfo | undefined;
+  /**
+   * Whether the host belongs to a statellite network.
+   */
+  satellite?: boolean | undefined;
+  /**
+   * The source of the data.
+   */
+  source?: string | undefined;
+};
+
+/** @internal */
+export const NetworkClassification$inboundSchema: z.ZodType<
+  NetworkClassification,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  hosting: z.boolean().optional(),
+  mobile: z.boolean().optional(),
+  mobile_info: NetworkMobileInfo$inboundSchema.optional(),
+  satellite: z.boolean().optional(),
+  source: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "mobile_info": "mobileInfo",
+  });
+});
+
+export function networkClassificationFromJSON(
+  jsonString: string,
+): SafeParseResult<NetworkClassification, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => NetworkClassification$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'NetworkClassification' from JSON`,
+  );
+}