fluidapi 0.0.3

package/src/models/issue-token-request.ts

@@ -0,0 +1,66 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../lib/primitives.js";
+import { ClosedEnum } from "../types/enums.js";
+
+export const GrantType = {
+  ClientCredentials: "client_credentials",
+} as const;
+export type GrantType = ClosedEnum<typeof GrantType>;
+
+export type IssueTokenRequest = {
+  grantType: GrantType;
+  clientId: string;
+  clientSecret: string;
+  /**
+   * Space-separated list of scopes to request. Must be a subset of the
+   *
+   * @remarks
+   * scopes configured for the tenant. Omit to request all available scopes.
+   */
+  scope?: string | undefined;
+};
+
+/** @internal */
+export const GrantType$outboundSchema: z.ZodMiniEnum<typeof GrantType> = z.enum(
+  GrantType,
+);
+
+/** @internal */
+export type IssueTokenRequest$Outbound = {
+  grant_type: string;
+  client_id: string;
+  client_secret: string;
+  scope?: string | undefined;
+};
+
+/** @internal */
+export const IssueTokenRequest$outboundSchema: z.ZodMiniType<
+  IssueTokenRequest$Outbound,
+  IssueTokenRequest
+> = z.pipe(
+  z.object({
+    grantType: GrantType$outboundSchema,
+    clientId: z.string(),
+    clientSecret: z.string(),
+    scope: z.optional(z.string()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      grantType: "grant_type",
+      clientId: "client_id",
+      clientSecret: "client_secret",
+    });
+  }),
+);
+
+export function issueTokenRequestToJSON(
+  issueTokenRequest: IssueTokenRequest,
+): string {
+  return JSON.stringify(
+    IssueTokenRequest$outboundSchema.parse(issueTokenRequest),
+  );
+}

package/src/models/jwk-set.ts

@@ -0,0 +1,57 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export type Key = {
+  kty: string;
+  kid: string;
+  use: string;
+  alg: string;
+  n: string;
+  e: string;
+};
+
+export type JWKSet = {
+  keys: Array<Key>;
+};
+
+/** @internal */
+export const Key$inboundSchema: z.ZodMiniType<Key, unknown> = z.object({
+  kty: types.string(),
+  kid: types.string(),
+  use: types.string(),
+  alg: types.string(),
+  n: types.string(),
+  e: types.string(),
+});
+
+export function keyFromJSON(
+  jsonString: string,
+): SafeParseResult<Key, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Key$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Key' from JSON`,
+  );
+}
+
+/** @internal */
+export const JWKSet$inboundSchema: z.ZodMiniType<JWKSet, unknown> = z.object({
+  keys: z.array(z.lazy(() => Key$inboundSchema)),
+});
+
+export function jwkSetFromJSON(
+  jsonString: string,
+): SafeParseResult<JWKSet, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => JWKSet$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'JWKSet' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -0,0 +1,7 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export * from "./issue-fluid-token.js";
+export * from "./issue-token.js";
+export * from "./issue-user-token.js";

package/src/models/operations/issue-fluid-token.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+import * as models from "../index.js";
+
+/**
+ * Fluid-signed M2M token issued
+ */
+export type IssueFluidTokenResponse = {
+  ok: boolean;
+  data?: models.TokenData | undefined;
+};
+
+/** @internal */
+export const IssueFluidTokenResponse$inboundSchema: z.ZodMiniType<
+  IssueFluidTokenResponse,
+  unknown
+> = z.object({
+  ok: types.boolean(),
+  data: types.optional(models.TokenData$inboundSchema),
+});
+
+export function issueFluidTokenResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<IssueFluidTokenResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => IssueFluidTokenResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'IssueFluidTokenResponse' from JSON`,
+  );
+}

package/src/models/operations/issue-token.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+import * as models from "../index.js";
+
+/**
+ * Access token issued
+ */
+export type IssueTokenResponse = {
+  ok: boolean;
+  data?: models.TokenData | undefined;
+};
+
+/** @internal */
+export const IssueTokenResponse$inboundSchema: z.ZodMiniType<
+  IssueTokenResponse,
+  unknown
+> = z.object({
+  ok: types.boolean(),
+  data: types.optional(models.TokenData$inboundSchema),
+});
+
+export function issueTokenResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<IssueTokenResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => IssueTokenResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'IssueTokenResponse' from JSON`,
+  );
+}

package/src/models/operations/issue-user-token.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+import * as models from "../index.js";
+
+/**
+ * User token issued
+ */
+export type IssueUserTokenResponse = {
+  ok: boolean;
+  data?: models.UserTokenData | undefined;
+};
+
+/** @internal */
+export const IssueUserTokenResponse$inboundSchema: z.ZodMiniType<
+  IssueUserTokenResponse,
+  unknown
+> = z.object({
+  ok: types.boolean(),
+  data: types.optional(models.UserTokenData$inboundSchema),
+});
+
+export function issueUserTokenResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<IssueUserTokenResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => IssueUserTokenResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'IssueUserTokenResponse' from JSON`,
+  );
+}

package/src/models/token-data.ts

@@ -0,0 +1,65 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+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 types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export const TokenType = {
+  Bearer: "bearer",
+} as const;
+export type TokenType = ClosedEnum<typeof TokenType>;
+
+export type TokenData = {
+  /**
+   * JWT access token
+   */
+  accessToken: string;
+  tokenType: TokenType;
+  /**
+   * Token lifetime in seconds
+   */
+  expiresIn: number;
+  /**
+   * Space-separated list of granted scopes
+   */
+  scope: string;
+};
+
+/** @internal */
+export const TokenType$inboundSchema: z.ZodMiniEnum<typeof TokenType> = z.enum(
+  TokenType,
+);
+
+/** @internal */
+export const TokenData$inboundSchema: z.ZodMiniType<TokenData, unknown> = z
+  .pipe(
+    z.object({
+      access_token: types.string(),
+      token_type: TokenType$inboundSchema,
+      expires_in: types.number(),
+      scope: types.string(),
+    }),
+    z.transform((v) => {
+      return remap$(v, {
+        "access_token": "accessToken",
+        "token_type": "tokenType",
+        "expires_in": "expiresIn",
+      });
+    }),
+  );
+
+export function tokenDataFromJSON(
+  jsonString: string,
+): SafeParseResult<TokenData, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => TokenData$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'TokenData' from JSON`,
+  );
+}

package/src/models/user-token-data.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export type UserTokenData = {
+  accessToken: string;
+  tokenType: string;
+  expiresIn?: number | undefined;
+};
+
+/** @internal */
+export const UserTokenData$inboundSchema: z.ZodMiniType<
+  UserTokenData,
+  unknown
+> = z.pipe(
+  z.object({
+    access_token: types.string(),
+    token_type: types.string(),
+    expires_in: types.optional(types.number()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      "access_token": "accessToken",
+      "token_type": "tokenType",
+      "expires_in": "expiresIn",
+    });
+  }),
+);
+
+export function userTokenDataFromJSON(
+  jsonString: string,
+): SafeParseResult<UserTokenData, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => UserTokenData$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'UserTokenData' from JSON`,
+  );
+}

package/src/models/user-token-request.ts

@@ -0,0 +1,60 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../lib/primitives.js";
+
+export type UserTokenRequest = {
+  externalId: string;
+  customerExternalId?: string | undefined;
+  email?: string | undefined;
+  givenName?: string | undefined;
+  familyName?: string | undefined;
+  /**
+   * Optional token lifetime in seconds.
+   */
+  expiresIn?: number | undefined;
+};
+
+/** @internal */
+export type UserTokenRequest$Outbound = {
+  external_id: string;
+  customer_external_id?: string | undefined;
+  email?: string | undefined;
+  given_name?: string | undefined;
+  family_name?: string | undefined;
+  expires_in?: number | undefined;
+};
+
+/** @internal */
+export const UserTokenRequest$outboundSchema: z.ZodMiniType<
+  UserTokenRequest$Outbound,
+  UserTokenRequest
+> = z.pipe(
+  z.object({
+    externalId: z.string(),
+    customerExternalId: z.optional(z.string()),
+    email: z.optional(z.string()),
+    givenName: z.optional(z.string()),
+    familyName: z.optional(z.string()),
+    expiresIn: z.optional(z.int()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      externalId: "external_id",
+      customerExternalId: "customer_external_id",
+      givenName: "given_name",
+      familyName: "family_name",
+      expiresIn: "expires_in",
+    });
+  }),
+);
+
+export function userTokenRequestToJSON(
+  userTokenRequest: UserTokenRequest,
+): string {
+  return JSON.stringify(
+    UserTokenRequest$outboundSchema.parse(userTokenRequest),
+  );
+}

package/src/sdk/index.ts

@@ -0,0 +1,5 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export * from "./sdk.js";

package/src/sdk/metadata.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { metadataGetJWKS } from "../funcs/metadata-get-jwks.js";
+import { metadataHealthCheck } from "../funcs/metadata-health-check.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Metadata extends ClientSDK {
+  /**
+   * Health check
+   */
+  async healthCheck(
+    options?: RequestOptions,
+  ): Promise<models.HealthResponse> {
+    return unwrapAsync(metadataHealthCheck(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Get public signing keys
+   *
+   * @remarks
+   * Returns the JWKS used to validate Fluid-signed JWTs.
+   */
+  async getJWKS(
+    options?: RequestOptions,
+  ): Promise<models.JWKSet> {
+    return unwrapAsync(metadataGetJWKS(
+      this,
+      options,
+    ));
+  }
+}

package/src/sdk/sdk.ts

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ClientSDK } from "../lib/sdks.js";
+import { Metadata } from "./metadata.js";
+import { Tokens } from "./tokens.js";
+
+export class Fluidapi extends ClientSDK {
+  private _metadata?: Metadata;
+  get metadata(): Metadata {
+    return (this._metadata ??= new Metadata(this._options));
+  }
+
+  private _tokens?: Tokens;
+  get tokens(): Tokens {
+    return (this._tokens ??= new Tokens(this._options));
+  }
+}

package/src/sdk/tokens.ts

@@ -0,0 +1,100 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { tokensIssueFluidToken } from "../funcs/tokens-issue-fluid-token.js";
+import { tokensIssueToken } from "../funcs/tokens-issue-token.js";
+import { tokensIssueUserToken } from "../funcs/tokens-issue-user-token.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Tokens extends ClientSDK {
+  /**
+   * Issue access token (client_credentials)
+   *
+   * @remarks
+   * Standard OAuth2 token endpoint. Performs a `client_credentials` grant
+   * against the Authorization Server and returns the access token (JWT).
+   *
+   * The OAuth2 client must be registered first via
+   * `POST /v1/tenants/{tenant_id}/credentials`.
+   *
+   * ### Scope reduction
+   *
+   * By default the token is issued with all scopes configured for the tenant.
+   * You can request a subset by passing `scope` in the form body.
+   * Requesting a scope not in the tenant's allowlist returns `400 invalid_scope`.
+   *
+   * **Available scopes:** `fluid:api`
+   */
+  async issueToken(
+    request: models.IssueTokenRequest,
+    options?: RequestOptions,
+  ): Promise<operations.IssueTokenResponse> {
+    return unwrapAsync(tokensIssueToken(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Issue Fluid-signed M2M token
+   *
+   * @remarks
+   * Validates client credentials against the Authorization Server and then
+   * generates a JWT signed by Fluid.
+   *
+   * This endpoint coexists with `/oauth2/token`.
+   * Use `/oauth2/token` when you want the standard Hydra-backed token flow.
+   * Use `/oauth2/token-fluid` when you need a Fluid-signed JWT carrying
+   * `workspace_id`, `tenant_id`, `client_id`, and `credential_type` claims for M2M calls.
+   */
+  async issueFluidToken(
+    request: models.IssueTokenRequest,
+    options?: RequestOptions,
+  ): Promise<operations.IssueFluidTokenResponse> {
+    return unwrapAsync(tokensIssueFluidToken(
+      this,
+      request,
+      options,
+    ));
+  }
+
+  /**
+   * Issue end-user token
+   *
+   * @remarks
+   * Issues a JWT for an end user (workspace user or customer user).
+   *
+   * Supported authentication modes:
+   * - `Authorization: Bearer <m2m_token>` — preferred. The token must be a
+   *   Fluid-signed M2M JWT with `scope` including `fluid:api`.
+   *   Canonical first-access provisioning via external lookup/create is only
+   *   available in this mode.
+   * - HTTP Basic Auth with `client_id` + `client_secret`.
+   *   In this mode the service does not perform canonical lookup/create.
+   *
+   * If `customer_external_id` is present, the JWT is issued with `scope: customer`.
+   * Otherwise it is issued with `scope: workspace`.
+   *
+   * When canonical first-access provisioning is enabled, `email` is required
+   * so the service can lookup or create the canonical user before issuing the token.
+   *
+   * When canonical provisioning is disabled by server configuration, the
+   * service may materialize local IAM context by assuming `external_id` is
+   * already the canonical `user_id`.
+   */
+  async issueUserToken(
+    request: models.UserTokenRequest,
+    options?: RequestOptions,
+  ): Promise<operations.IssueUserTokenResponse> {
+    return unwrapAsync(tokensIssueUserToken(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/types/async.ts

@@ -0,0 +1,68 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export type APICall =
+  | {
+      status: "complete";
+      request: Request;
+      response: Response;
+    }
+  | {
+      status: "request-error";
+      request: Request;
+      response?: undefined;
+    }
+  | {
+      status: "invalid";
+      request?: undefined;
+      response?: undefined;
+    };
+
+export class APIPromise<T> implements Promise<T> {
+  readonly #promise: Promise<[T, APICall]>;
+  readonly #unwrapped: Promise<T>;
+
+  readonly [Symbol.toStringTag] = "APIPromise";
+
+  constructor(p: [T, APICall] | Promise<[T, APICall]>) {
+    this.#promise = p instanceof Promise ? p : Promise.resolve(p);
+    this.#unwrapped =
+      p instanceof Promise
+        ? this.#promise.then(([value]) => value)
+        : Promise.resolve(p[0]);
+  }
+
+  then<TResult1 = T, TResult2 = never>(
+    onfulfilled?:
+      | ((value: T) => TResult1 | PromiseLike<TResult1>)
+      | null
+      | undefined,
+    onrejected?:
+      | ((reason: any) => TResult2 | PromiseLike<TResult2>)
+      | null
+      | undefined,
+  ): Promise<TResult1 | TResult2> {
+    return this.#promise.then(
+      onfulfilled ? ([value]) => onfulfilled(value) : void 0,
+      onrejected,
+    );
+  }
+
+  catch<TResult = never>(
+    onrejected?:
+      | ((reason: any) => TResult | PromiseLike<TResult>)
+      | null
+      | undefined,
+  ): Promise<T | TResult> {
+    return this.#unwrapped.catch(onrejected);
+  }
+
+  finally(onfinally?: (() => void) | null | undefined): Promise<T> {
+    return this.#unwrapped.finally(onfinally);
+  }
+
+  $inspect(): Promise<[T, APICall]> {
+    return this.#promise;
+  }
+}

package/src/types/blobs.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+
+export const blobLikeSchema: z.ZodMiniType<Blob, Blob> = z.custom<Blob>(
+  isBlobLike,
+  {
+    message: "expected a Blob, File or Blob-like object",
+    abort: true,
+  },
+);
+
+export function isBlobLike(val: unknown): val is Blob {
+  if (val instanceof Blob) {
+    return true;
+  }
+
+  if (typeof val !== "object" || val == null || !(Symbol.toStringTag in val)) {
+    return false;
+  }
+
+  const name = val[Symbol.toStringTag];
+  if (typeof name !== "string") {
+    return false;
+  }
+  if (name !== "Blob" && name !== "File") {
+    return false;
+  }
+
+  return "stream" in val && typeof val.stream === "function";
+}