@tearleads/client-sdk 0.0.0-stage → 0.1.13

package/internal/validators/operation/containerReads.js

@@ -0,0 +1,124 @@
+import { z } from "zod";
+import { containerDocumentRuntimeRefinements, containerKekLogResponseRuntimeRefinements, containerParentLaneRuntimeRefinements, } from "../containerReadRefinements.js";
+import { registerJsonSchemaFragment, registerJsonSchemaRuntimeRefinements, registerJsonSchemaView, } from "../jsonSchema.js";
+import { isListContainerParentLanesRequest, ListContainerParentLanesRequestSchema, } from "../request/index.js";
+import { ContainerKekLogResponseSchema, ContainerNotFoundErrorResponseSchema, ErrorResponseSchema, isContainerKekLogResponse, isListContainerDocumentsResponse, isListContainerParentLanesResponse, ListContainerDocumentsResponseSchema, ListContainerParentLanesResponseSchema, SessionFailureResponseSchema, } from "../response/index.js";
+import { loosePlainObject, plainObjectSchema } from "../schema.js";
+import { MAX_CONTAINER_KEY_EPOCH } from "../util/index.js";
+import { defineJsonOperation } from "./definition.js";
+const DIGITS_PATTERN = /^\d+$/u;
+function listPageLimitSchema() {
+    const jsonSchema = { minimum: 1, type: "integer" };
+    const inputSchema = registerJsonSchemaFragment(z.union([z.number(), z.string()]).superRefine((value, context) => {
+        if (typeof value === "string" && !DIGITS_PATTERN.test(value)) {
+            context.addIssue({ code: "custom", message: "Invalid limit" });
+            return;
+        }
+        const parsed = Number(value);
+        if (!Number.isSafeInteger(parsed) || parsed < 1) {
+            context.addIssue({ code: "custom", message: "Invalid limit" });
+        }
+    }), jsonSchema);
+    return registerJsonSchemaFragment(inputSchema.transform(Number), jsonSchema);
+}
+function containerKekLogEpochQuerySchema() {
+    return registerJsonSchemaFragment(z.union([z.number(), z.string()]).refine((value) => {
+        if (typeof value === "string" && !DIGITS_PATTERN.test(value))
+            return false;
+        const parsed = Number(value);
+        return (Number.isSafeInteger(parsed) &&
+            parsed > 0 &&
+            parsed <= MAX_CONTAINER_KEY_EPOCH);
+    }, "Invalid key epoch"), {
+        maximum: MAX_CONTAINER_KEY_EPOCH,
+        minimum: 1,
+        type: "integer",
+    });
+}
+export const ContainerReadPathParamsSchema = z.strictObject({
+    containerId: z.string(),
+});
+export const ContainerKekLogQuerySchema = loosePlainObject({
+    keyringForEpoch: containerKekLogEpochQuerySchema().optional(),
+    afterKeyEpoch: containerKekLogEpochQuerySchema().optional(),
+});
+const listContainerDocumentsQueryShape = {
+    watermarkUpdatedAt: z.string().optional(),
+    watermarkId: z.string().optional(),
+    limit: listPageLimitSchema().optional(),
+};
+const listContainerDocumentsQueryObjectSchema = z.looseObject(listContainerDocumentsQueryShape);
+export const ListContainerDocumentsQuerySchema = registerJsonSchemaRuntimeRefinements(registerJsonSchemaView(plainObjectSchema
+    .pipe(listContainerDocumentsQueryObjectSchema)
+    .superRefine(({ watermarkId, watermarkUpdatedAt }, context) => {
+    const isValid = (watermarkId === undefined && watermarkUpdatedAt === undefined) ||
+        (watermarkId !== undefined &&
+            watermarkUpdatedAt !== undefined &&
+            watermarkId.length > 0 &&
+            watermarkUpdatedAt.length > 0 &&
+            !Number.isNaN(new Date(watermarkUpdatedAt).getTime()));
+    if (!isValid) {
+        context.addIssue({
+            code: "custom",
+            message: "Invalid watermark",
+            path: ["watermarkUpdatedAt"],
+        });
+    }
+}), listContainerDocumentsQueryObjectSchema), containerDocumentRuntimeRefinements);
+const containerReadFailureResponses = {
+    400: ErrorResponseSchema,
+    401: SessionFailureResponseSchema,
+    403: ErrorResponseSchema,
+    404: ErrorResponseSchema,
+    409: ErrorResponseSchema,
+    500: ErrorResponseSchema,
+};
+const containerReadFailureStatuses = [400, 401, 403, 404, 409, 500];
+export const getContainerKekLogOperation = defineJsonOperation({
+    auth: "session",
+    failureResponses: containerReadFailureResponses,
+    failureStatuses: containerReadFailureStatuses,
+    id: "containers.kekLog.get",
+    method: "GET",
+    params: ContainerReadPathParamsSchema,
+    path: "/containers/{containerId}/kek-log",
+    query: ContainerKekLogQuerySchema,
+    responses: { 200: ContainerKekLogResponseSchema },
+    runtimeRefinements: containerKekLogResponseRuntimeRefinements,
+});
+export const listContainerDocumentsOperation = defineJsonOperation({
+    auth: "session",
+    failureResponses: {
+        ...containerReadFailureResponses,
+        404: ContainerNotFoundErrorResponseSchema,
+    },
+    failureStatuses: containerReadFailureStatuses,
+    id: "containers.documents.list",
+    method: "GET",
+    params: ContainerReadPathParamsSchema,
+    path: "/containers/{containerId}/documents",
+    query: ListContainerDocumentsQuerySchema,
+    responses: { 200: ListContainerDocumentsResponseSchema },
+    runtimeRefinements: containerDocumentRuntimeRefinements,
+});
+export const listContainerParentLanesOperation = defineJsonOperation({
+    auth: "session",
+    body: ListContainerParentLanesRequestSchema,
+    failureResponses: {
+        400: ErrorResponseSchema,
+        401: SessionFailureResponseSchema,
+        500: ErrorResponseSchema,
+    },
+    failureStatuses: [400, 401, 500],
+    id: "containers.parentLanes.query",
+    method: "POST",
+    params: z.strictObject({}),
+    path: "/containers/parent-lanes/query",
+    responses: { 200: ListContainerParentLanesResponseSchema },
+    runtimeRefinements: containerParentLaneRuntimeRefinements,
+});
+export const isGetContainerKekLogOperationResponse = isContainerKekLogResponse;
+export const isListContainerDocumentsOperationResponse = isListContainerDocumentsResponse;
+export const isListContainerParentLanesOperationRequest = isListContainerParentLanesRequest;
+export const isListContainerParentLanesOperationResponse = isListContainerParentLanesResponse;
+//# sourceMappingURL=containerReads.js.map

package/internal/validators/operation/containerReads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerReads.js","sourceRoot":"","sources":["containerReads.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport {\n  containerDocumentRuntimeRefinements,\n  containerKekLogResponseRuntimeRefinements,\n  containerParentLaneRuntimeRefinements,\n} from \"../containerReadRefinements\";\nimport {\n  registerJsonSchemaFragment,\n  registerJsonSchemaRuntimeRefinements,\n  registerJsonSchemaView,\n} from \"../jsonSchema\";\nimport {\n  isListContainerParentLanesRequest,\n  ListContainerParentLanesRequestSchema,\n} from \"../request\";\nimport {\n  ContainerKekLogResponseSchema,\n  ContainerNotFoundErrorResponseSchema,\n  ErrorResponseSchema,\n  isContainerKekLogResponse,\n  isListContainerDocumentsResponse,\n  isListContainerParentLanesResponse,\n  ListContainerDocumentsResponseSchema,\n  ListContainerParentLanesResponseSchema,\n  SessionFailureResponseSchema,\n} from \"../response\";\nimport { loosePlainObject, plainObjectSchema } from \"../schema\";\nimport { MAX_CONTAINER_KEY_EPOCH } from \"../util\";\nimport { defineJsonOperation } from \"./definition\";\n\nconst DIGITS_PATTERN = /^\\d+$/u;\n\nfunction listPageLimitSchema() {\n  const jsonSchema = { minimum: 1, type: \"integer\" } as const;\n  const inputSchema = registerJsonSchemaFragment(\n    z.union([z.number(), z.string()]).superRefine((value, context) => {\n      if (typeof value === \"string\" && !DIGITS_PATTERN.test(value)) {\n        context.addIssue({ code: \"custom\", message: \"Invalid limit\" });\n        return;\n      }\n\n      const parsed = Number(value);\n      if (!Number.isSafeInteger(parsed) || parsed < 1) {\n        context.addIssue({ code: \"custom\", message: \"Invalid limit\" });\n      }\n    }),\n    jsonSchema,\n  );\n\n  return registerJsonSchemaFragment(inputSchema.transform(Number), jsonSchema);\n}\n\nfunction containerKekLogEpochQuerySchema() {\n  return registerJsonSchemaFragment(\n    z.union([z.number(), z.string()]).refine((value) => {\n      if (typeof value === \"string\" && !DIGITS_PATTERN.test(value))\n        return false;\n      const parsed = Number(value);\n      return (\n        Number.isSafeInteger(parsed) &&\n        parsed > 0 &&\n        parsed <= MAX_CONTAINER_KEY_EPOCH\n      );\n    }, \"Invalid key epoch\"),\n    {\n      maximum: MAX_CONTAINER_KEY_EPOCH,\n      minimum: 1,\n      type: \"integer\",\n    },\n  );\n}\n\nexport const ContainerReadPathParamsSchema = z.strictObject({\n  containerId: z.string(),\n});\n\nexport const ContainerKekLogQuerySchema = loosePlainObject({\n  keyringForEpoch: containerKekLogEpochQuerySchema().optional(),\n  afterKeyEpoch: containerKekLogEpochQuerySchema().optional(),\n});\n\nconst listContainerDocumentsQueryShape = {\n  watermarkUpdatedAt: z.string().optional(),\n  watermarkId: z.string().optional(),\n  limit: listPageLimitSchema().optional(),\n} as const;\nconst listContainerDocumentsQueryObjectSchema = z.looseObject(\n  listContainerDocumentsQueryShape,\n);\n\nexport const ListContainerDocumentsQuerySchema =\n  registerJsonSchemaRuntimeRefinements(\n    registerJsonSchemaView(\n      plainObjectSchema\n        .pipe(listContainerDocumentsQueryObjectSchema)\n        .superRefine(({ watermarkId, watermarkUpdatedAt }, context) => {\n          const isValid =\n            (watermarkId === undefined && watermarkUpdatedAt === undefined) ||\n            (watermarkId !== undefined &&\n              watermarkUpdatedAt !== undefined &&\n              watermarkId.length > 0 &&\n              watermarkUpdatedAt.length > 0 &&\n              !Number.isNaN(new Date(watermarkUpdatedAt).getTime()));\n          if (!isValid) {\n            context.addIssue({\n              code: \"custom\",\n              message: \"Invalid watermark\",\n              path: [\"watermarkUpdatedAt\"],\n            });\n          }\n        }),\n      listContainerDocumentsQueryObjectSchema,\n    ),\n    containerDocumentRuntimeRefinements,\n  );\n\nexport type ContainerReadPathParams = z.infer<\n  typeof ContainerReadPathParamsSchema\n>;\nexport type ContainerKekLogQuery = z.infer<typeof ContainerKekLogQuerySchema>;\nexport type ListContainerDocumentsQuery = z.infer<\n  typeof ListContainerDocumentsQuerySchema\n>;\n\nconst containerReadFailureResponses = {\n  400: ErrorResponseSchema,\n  401: SessionFailureResponseSchema,\n  403: ErrorResponseSchema,\n  404: ErrorResponseSchema,\n  409: ErrorResponseSchema,\n  500: ErrorResponseSchema,\n} as const;\n\nconst containerReadFailureStatuses = [400, 401, 403, 404, 409, 500] as const;\n\nexport const getContainerKekLogOperation = defineJsonOperation({\n  auth: \"session\",\n  failureResponses: containerReadFailureResponses,\n  failureStatuses: containerReadFailureStatuses,\n  id: \"containers.kekLog.get\",\n  method: \"GET\",\n  params: ContainerReadPathParamsSchema,\n  path: \"/containers/{containerId}/kek-log\",\n  query: ContainerKekLogQuerySchema,\n  responses: { 200: ContainerKekLogResponseSchema },\n  runtimeRefinements: containerKekLogResponseRuntimeRefinements,\n});\n\nexport const listContainerDocumentsOperation = defineJsonOperation({\n  auth: \"session\",\n  failureResponses: {\n    ...containerReadFailureResponses,\n    404: ContainerNotFoundErrorResponseSchema,\n  },\n  failureStatuses: containerReadFailureStatuses,\n  id: \"containers.documents.list\",\n  method: \"GET\",\n  params: ContainerReadPathParamsSchema,\n  path: \"/containers/{containerId}/documents\",\n  query: ListContainerDocumentsQuerySchema,\n  responses: { 200: ListContainerDocumentsResponseSchema },\n  runtimeRefinements: containerDocumentRuntimeRefinements,\n});\n\nexport const listContainerParentLanesOperation = defineJsonOperation({\n  auth: \"session\",\n  body: ListContainerParentLanesRequestSchema,\n  failureResponses: {\n    400: ErrorResponseSchema,\n    401: SessionFailureResponseSchema,\n    500: ErrorResponseSchema,\n  },\n  failureStatuses: [400, 401, 500],\n  id: \"containers.parentLanes.query\",\n  method: \"POST\",\n  params: z.strictObject({}),\n  path: \"/containers/parent-lanes/query\",\n  responses: { 200: ListContainerParentLanesResponseSchema },\n  runtimeRefinements: containerParentLaneRuntimeRefinements,\n});\n\nexport const isGetContainerKekLogOperationResponse = isContainerKekLogResponse;\nexport const isListContainerDocumentsOperationResponse =\n  isListContainerDocumentsResponse;\nexport const isListContainerParentLanesOperationRequest =\n  isListContainerParentLanesRequest;\nexport const isListContainerParentLanesOperationResponse =\n  isListContainerParentLanesResponse;\n"]}

package/internal/validators/operation/containerReplacement.d.ts

@@ -0,0 +1,172 @@
+import { z } from "zod";
+import { ErrorResponseSchema } from "../response/index.js";
+export declare const ContainerReplacementAuthorizationsResponseSchema: z.ZodObject<{
+    authorizations: z.ZodArray<z.ZodObject<{
+        replacesOrganizationId: z.ZodCustom<string, string>;
+        organizationId: z.ZodCustom<string, string>;
+        rootContainerId: z.ZodCustom<string, string>;
+        userId: z.ZodCustom<string, string>;
+        organizationStateHash: z.ZodCustom<string, string>;
+        adminGroupId: z.ZodCustom<string, string>;
+        adminGroupStateHash: z.ZodCustom<string, string>;
+        memberGroupId: z.ZodCustom<string, string>;
+        memberGroupStateHash: z.ZodCustom<string, string>;
+        rootManifestHash: z.ZodCustom<string, string>;
+        rootMetadataDocumentId: z.ZodCustom<string, string>;
+        signature: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+export type ContainerReplacementAuthorizationsResponse = z.infer<typeof ContainerReplacementAuthorizationsResponseSchema>;
+export declare const getContainerReplacementAuthorizationsOperation: Omit<{
+    readonly auth: "session";
+    readonly failureResponses: {
+        readonly 400: z.ZodType<{
+            error: string;
+        }, {
+            error: string;
+        }, z.core.$ZodTypeInternals<{
+            error: string;
+        }, {
+            error: string;
+        }>>;
+        readonly 401: z.ZodType<{
+            error: string;
+            code?: "session_refresh_required" | undefined;
+        }, {
+            error: string;
+            code?: "session_refresh_required" | undefined;
+        }, z.core.$ZodTypeInternals<{
+            error: string;
+            code?: "session_refresh_required" | undefined;
+        }, {
+            error: string;
+            code?: "session_refresh_required" | undefined;
+        }>>;
+        readonly 403: z.ZodType<{
+            error: string;
+        }, {
+            error: string;
+        }, z.core.$ZodTypeInternals<{
+            error: string;
+        }, {
+            error: string;
+        }>>;
+        readonly 404: z.ZodType<{
+            error: string;
+        }, {
+            error: string;
+        }, z.core.$ZodTypeInternals<{
+            error: string;
+        }, {
+            error: string;
+        }>>;
+        readonly 409: z.ZodType<{
+            error: string;
+        }, {
+            error: string;
+        }, z.core.$ZodTypeInternals<{
+            error: string;
+        }, {
+            error: string;
+        }>>;
+        readonly 500: z.ZodType<{
+            error: string;
+        }, {
+            error: string;
+        }, z.core.$ZodTypeInternals<{
+            error: string;
+        }, {
+            error: string;
+        }>>;
+    };
+    readonly failureStatuses: readonly [400, 401, 403, 404, 409, 500];
+    readonly id: "containers.replacementAuthorizations.get";
+    readonly method: "GET";
+    readonly params: z.ZodObject<{
+        containerId: z.ZodCustom<string, string>;
+        replacesOrganizationId: z.ZodCustom<string, string>;
+    }, z.core.$strict>;
+    readonly path: "/containers/{containerId}/replacement-authorizations/{replacesOrganizationId}";
+    readonly responses: {
+        readonly 200: z.ZodObject<{
+            authorizations: z.ZodArray<z.ZodObject<{
+                replacesOrganizationId: z.ZodCustom<string, string>;
+                organizationId: z.ZodCustom<string, string>;
+                rootContainerId: z.ZodCustom<string, string>;
+                userId: z.ZodCustom<string, string>;
+                organizationStateHash: z.ZodCustom<string, string>;
+                adminGroupId: z.ZodCustom<string, string>;
+                adminGroupStateHash: z.ZodCustom<string, string>;
+                memberGroupId: z.ZodCustom<string, string>;
+                memberGroupStateHash: z.ZodCustom<string, string>;
+                rootManifestHash: z.ZodCustom<string, string>;
+                rootMetadataDocumentId: z.ZodCustom<string, string>;
+                signature: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strip>;
+    };
+}, "failureResponses" | "failureStatuses"> & {
+    readonly failureResponses: {
+        readonly 400: z.ZodType<{
+            error: string;
+        }, {
+            error: string;
+        }, z.core.$ZodTypeInternals<{
+            error: string;
+        }, {
+            error: string;
+        }>>;
+        readonly 401: z.ZodType<{
+            error: string;
+            code?: "session_refresh_required" | undefined;
+        }, {
+            error: string;
+            code?: "session_refresh_required" | undefined;
+        }, z.core.$ZodTypeInternals<{
+            error: string;
+            code?: "session_refresh_required" | undefined;
+        }, {
+            error: string;
+            code?: "session_refresh_required" | undefined;
+        }>>;
+        readonly 403: z.ZodType<{
+            error: string;
+        }, {
+            error: string;
+        }, z.core.$ZodTypeInternals<{
+            error: string;
+        }, {
+            error: string;
+        }>>;
+        readonly 404: z.ZodType<{
+            error: string;
+        }, {
+            error: string;
+        }, z.core.$ZodTypeInternals<{
+            error: string;
+        }, {
+            error: string;
+        }>>;
+        readonly 409: z.ZodType<{
+            error: string;
+        }, {
+            error: string;
+        }, z.core.$ZodTypeInternals<{
+            error: string;
+        }, {
+            error: string;
+        }>>;
+        readonly 500: z.ZodType<{
+            error: string;
+        }, {
+            error: string;
+        }, z.core.$ZodTypeInternals<{
+            error: string;
+        }, {
+            error: string;
+        }>>;
+    } & {
+        readonly 503: typeof ErrorResponseSchema;
+    };
+    readonly failureStatuses: readonly [400, 401, 403, 404, 409, 500] | readonly [400, 401, 403, 404, 409, 500, 503];
+};

package/internal/validators/operation/containerReplacement.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { ErrorResponseSchema, SessionFailureResponseSchema } from "../response/index.js";
+import { uuidV4StringSchema } from "../schema.js";
+import { OrganizationReplacementAuthorizationSchema } from "../util/index.js";
+import { defineJsonOperation } from "./definition.js";
+export const ContainerReplacementAuthorizationsResponseSchema = z.object({
+    authorizations: z.array(OrganizationReplacementAuthorizationSchema),
+});
+export const getContainerReplacementAuthorizationsOperation = defineJsonOperation({
+    auth: "session",
+    failureResponses: {
+        400: ErrorResponseSchema,
+        401: SessionFailureResponseSchema,
+        403: ErrorResponseSchema,
+        404: ErrorResponseSchema,
+        409: ErrorResponseSchema,
+        500: ErrorResponseSchema,
+    },
+    failureStatuses: [400, 401, 403, 404, 409, 500],
+    id: "containers.replacementAuthorizations.get",
+    method: "GET",
+    params: z.strictObject({
+        containerId: uuidV4StringSchema,
+        replacesOrganizationId: uuidV4StringSchema,
+    }),
+    path: "/containers/{containerId}/replacement-authorizations/{replacesOrganizationId}",
+    responses: { 200: ContainerReplacementAuthorizationsResponseSchema },
+});
+//# sourceMappingURL=containerReplacement.js.map

package/internal/validators/operation/containerReplacement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerReplacement.js","sourceRoot":"","sources":["containerReplacement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,0CAA0C,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,CAAC,MAAM,gDAAgD,GAAG,CAAC,CAAC,MAAM,CAAC;IACvE,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,0CAA0C,CAAC;CACpE,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,8CAA8C,GACzD,mBAAmB,CAAC;IAClB,IAAI,EAAE,SAAS;IACf,gBAAgB,EAAE;QAChB,GAAG,EAAE,mBAAmB;QACxB,GAAG,EAAE,4BAA4B;QACjC,GAAG,EAAE,mBAAmB;QACxB,GAAG,EAAE,mBAAmB;QACxB,GAAG,EAAE,mBAAmB;QACxB,GAAG,EAAE,mBAAmB;KACzB;IACD,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAC/C,EAAE,EAAE,0CAA0C;IAC9C,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC;QACrB,WAAW,EAAE,kBAAkB;QAC/B,sBAAsB,EAAE,kBAAkB;KAC3C,CAAC;IACF,IAAI,EAAE,+EAA+E;IACrF,SAAS,EAAE,EAAE,GAAG,EAAE,gDAAgD,EAAE;CACrE,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { ErrorResponseSchema, SessionFailureResponseSchema } from \"../response\";\nimport { uuidV4StringSchema } from \"../schema\";\nimport { OrganizationReplacementAuthorizationSchema } from \"../util\";\nimport { defineJsonOperation } from \"./definition\";\n\nexport const ContainerReplacementAuthorizationsResponseSchema = z.object({\n  authorizations: z.array(OrganizationReplacementAuthorizationSchema),\n});\nexport type ContainerReplacementAuthorizationsResponse = z.infer<\n  typeof ContainerReplacementAuthorizationsResponseSchema\n>;\nexport const getContainerReplacementAuthorizationsOperation =\n  defineJsonOperation({\n    auth: \"session\",\n    failureResponses: {\n      400: ErrorResponseSchema,\n      401: SessionFailureResponseSchema,\n      403: ErrorResponseSchema,\n      404: ErrorResponseSchema,\n      409: ErrorResponseSchema,\n      500: ErrorResponseSchema,\n    },\n    failureStatuses: [400, 401, 403, 404, 409, 500],\n    id: \"containers.replacementAuthorizations.get\",\n    method: \"GET\",\n    params: z.strictObject({\n      containerId: uuidV4StringSchema,\n      replacesOrganizationId: uuidV4StringSchema,\n    }),\n    path: \"/containers/{containerId}/replacement-authorizations/{replacesOrganizationId}\",\n    responses: { 200: ContainerReplacementAuthorizationsResponseSchema },\n  });\n"]}

package/internal/validators/operation/definition.d.ts

@@ -0,0 +1,49 @@
+import type { z } from "zod";
+import { ErrorResponseSchema } from "../response/error.js";
+export type HttpOperationMethod = "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+export type JsonOperationMethod = HttpOperationMethod;
+export type HttpOperationMediaType = "application/json" | "application/octet-stream";
+export interface RuntimeRefinement {
+    readonly description: string;
+    readonly id: string;
+}
+export interface HttpOperation {
+    readonly auth: "none" | "session";
+    readonly body?: z.ZodType;
+    readonly emptyResponseStatuses?: readonly number[];
+    readonly failureResponses?: Readonly<Record<number, z.ZodType>>;
+    readonly failureStatuses: readonly number[];
+    readonly headers?: z.ZodType;
+    readonly id: string;
+    readonly method: HttpOperationMethod;
+    readonly params: z.ZodType;
+    readonly path: `/${string}`;
+    readonly query?: z.ZodType;
+    readonly requestMediaType?: HttpOperationMediaType;
+    readonly responseHeaders?: Readonly<Record<number, z.ZodType>>;
+    readonly responseMediaTypes?: Readonly<Record<number, HttpOperationMediaType>>;
+    readonly responseDescriptions?: Readonly<Record<number, string>>;
+    readonly responses: Readonly<Record<number, z.ZodType>>;
+    readonly runtimeRefinements?: readonly RuntimeRefinement[];
+}
+export interface JsonOperation extends HttpOperation {
+    readonly requestMediaType?: "application/json";
+    readonly responseMediaTypes?: Readonly<Record<number, "application/json">>;
+}
+export type OperationSchemaInput<Schema extends z.ZodType> = z.input<Schema>;
+export type OperationSchemaOutput<Schema extends z.ZodType> = z.output<Schema>;
+type OperationWithGlobalServiceUnavailable<Operation extends HttpOperation> = Omit<Operation, "failureResponses" | "failureStatuses"> & {
+    readonly failureResponses: (Operation["failureResponses"] extends Readonly<Record<number, z.ZodType>> ? Operation["failureResponses"] : object) & {
+        readonly 503: typeof ErrorResponseSchema;
+    };
+    readonly failureStatuses: Operation["failureStatuses"] | readonly [...Operation["failureStatuses"], 503];
+};
+export declare function defineHttpOperation<const Operation extends HttpOperation>(operation: Operation): OperationWithGlobalServiceUnavailable<Operation>;
+export declare function defineJsonOperation<const Operation extends JsonOperation>(operation: Operation): OperationWithGlobalServiceUnavailable<Operation>;
+export declare function operationRoutePath(operation: Pick<HttpOperation, "path">): string;
+export declare function operationRequestPath<Operation extends Pick<HttpOperation, "id" | "params" | "path">>(operation: Operation, params: z.input<Operation["params"]>): string;
+export declare function operationRequestPathWithQuery<QuerySchema extends z.ZodType, Operation extends Pick<HttpOperation, "id" | "params" | "path"> & {
+    readonly query: QuerySchema;
+}>(operation: Operation, params: z.input<Operation["params"]>, query: z.input<QuerySchema>): string;
+export declare function operationRequestPathForInput<Operation extends Pick<HttpOperation, "id" | "params" | "path" | "query">>(operation: Operation, params: z.input<Operation["params"]>, query: unknown): string;
+export {};

package/internal/validators/operation/definition.js

@@ -0,0 +1,76 @@
+import { isPlainObject } from "../isPlainObject.js";
+import { ErrorResponseSchema } from "../response/error.js";
+function withGlobalServiceUnavailable(operation) {
+    return {
+        ...operation,
+        failureResponses: {
+            503: ErrorResponseSchema,
+            ...operation.failureResponses,
+        },
+        failureStatuses: operation.failureStatuses.includes(503)
+            ? operation.failureStatuses
+            : [...operation.failureStatuses, 503],
+    };
+}
+export function defineHttpOperation(operation) {
+    return withGlobalServiceUnavailable(operation);
+}
+export function defineJsonOperation(operation) {
+    return withGlobalServiceUnavailable(operation);
+}
+const PATH_PARAMETER_PATTERN = /\{([^/{}]+)\}/g;
+export function operationRoutePath(operation) {
+    return operation.path.replace(PATH_PARAMETER_PATTERN, ":$1");
+}
+export function operationRequestPath(operation, params) {
+    const result = operation.params.safeParse(params);
+    if (!result.success) {
+        throw new TypeError(`Invalid path parameters for ${operation.id}`);
+    }
+    const values = result.data;
+    if (!isPlainObject(values)) {
+        throw new TypeError(`Invalid path parameters for ${operation.id}`);
+    }
+    return operation.path.replace(PATH_PARAMETER_PATTERN, (_, name) => {
+        const value = values[name];
+        if (typeof value !== "string" && typeof value !== "number") {
+            throw new TypeError(`Invalid path parameter "${name}" for ${operation.id}`);
+        }
+        return encodeURIComponent(String(value));
+    });
+}
+export function operationRequestPathWithQuery(operation, params, query) {
+    const path = operationRequestPath(operation, params);
+    return appendOperationQuery(operation.id, operation.query, path, query);
+}
+export function operationRequestPathForInput(operation, params, query) {
+    const path = operationRequestPath(operation, params);
+    if (!operation.query) {
+        if (query !== undefined) {
+            throw new TypeError(`Invalid query parameters for ${operation.id}`);
+        }
+        return path;
+    }
+    return appendOperationQuery(operation.id, operation.query, path, query);
+}
+function appendOperationQuery(operationId, querySchema, path, query) {
+    const result = querySchema.safeParse(query);
+    if (!result.success || !isPlainObject(result.data)) {
+        throw new TypeError(`Invalid query parameters for ${operationId}`);
+    }
+    const searchParams = new URLSearchParams();
+    for (const [name, value] of Object.entries(result.data)) {
+        if (value === undefined) {
+            continue;
+        }
+        if (typeof value !== "string" &&
+            typeof value !== "number" &&
+            typeof value !== "boolean") {
+            throw new TypeError(`Invalid query parameter "${name}" for ${operationId}`);
+        }
+        searchParams.set(name, String(value));
+    }
+    const queryString = searchParams.toString();
+    return queryString.length === 0 ? path : `${path}?${queryString}`;
+}
+//# sourceMappingURL=definition.js.map

package/internal/validators/operation/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["definition.ts"],"names":[],"mappings":"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","sourcesContent":["import type { z } from \"zod\";\nimport { isPlainObject } from \"../isPlainObject\";\nimport { ErrorResponseSchema } from \"../response/error\";\n\nexport type HttpOperationMethod = \"DELETE\" | \"GET\" | \"PATCH\" | \"POST\" | \"PUT\";\nexport type JsonOperationMethod = HttpOperationMethod;\nexport type HttpOperationMediaType =\n  | \"application/json\"\n  | \"application/octet-stream\";\n\nexport interface RuntimeRefinement {\n  readonly description: string;\n  readonly id: string;\n}\n\nexport interface HttpOperation {\n  readonly auth: \"none\" | \"session\";\n  readonly body?: z.ZodType;\n  readonly emptyResponseStatuses?: readonly number[];\n  readonly failureResponses?: Readonly<Record<number, z.ZodType>>;\n  readonly failureStatuses: readonly number[];\n  readonly headers?: z.ZodType;\n  readonly id: string;\n  readonly method: HttpOperationMethod;\n  readonly params: z.ZodType;\n  readonly path: `/${string}`;\n  readonly query?: z.ZodType;\n  readonly requestMediaType?: HttpOperationMediaType;\n  readonly responseHeaders?: Readonly<Record<number, z.ZodType>>;\n  readonly responseMediaTypes?: Readonly<\n    Record<number, HttpOperationMediaType>\n  >;\n  readonly responseDescriptions?: Readonly<Record<number, string>>;\n  readonly responses: Readonly<Record<number, z.ZodType>>;\n  readonly runtimeRefinements?: readonly RuntimeRefinement[];\n}\n\nexport interface JsonOperation extends HttpOperation {\n  readonly requestMediaType?: \"application/json\";\n  readonly responseMediaTypes?: Readonly<Record<number, \"application/json\">>;\n}\n\nexport type OperationSchemaInput<Schema extends z.ZodType> = z.input<Schema>;\nexport type OperationSchemaOutput<Schema extends z.ZodType> = z.output<Schema>;\n\ntype OperationWithGlobalServiceUnavailable<Operation extends HttpOperation> =\n  Omit<Operation, \"failureResponses\" | \"failureStatuses\"> & {\n    readonly failureResponses: (Operation[\"failureResponses\"] extends Readonly<\n      Record<number, z.ZodType>\n    >\n      ? Operation[\"failureResponses\"]\n      : object) & { readonly 503: typeof ErrorResponseSchema };\n    readonly failureStatuses:\n      | Operation[\"failureStatuses\"]\n      | readonly [...Operation[\"failureStatuses\"], 503];\n  };\n\n// The API's outer error boundary maps transient database failures to this\n// envelope before any route-specific handler can respond. Keep it in the\n// operation constructor so every routed contract and client decoder agrees.\nfunction withGlobalServiceUnavailable<const Operation extends HttpOperation>(\n  operation: Operation,\n): OperationWithGlobalServiceUnavailable<Operation>;\nfunction withGlobalServiceUnavailable(\n  operation: HttpOperation,\n): OperationWithGlobalServiceUnavailable<HttpOperation> {\n  return {\n    ...operation,\n    failureResponses: {\n      503: ErrorResponseSchema,\n      ...operation.failureResponses,\n    },\n    failureStatuses: operation.failureStatuses.includes(503)\n      ? operation.failureStatuses\n      : [...operation.failureStatuses, 503],\n  };\n}\n\nexport function defineHttpOperation<const Operation extends HttpOperation>(\n  operation: Operation,\n): OperationWithGlobalServiceUnavailable<Operation> {\n  return withGlobalServiceUnavailable(operation);\n}\n\nexport function defineJsonOperation<const Operation extends JsonOperation>(\n  operation: Operation,\n): OperationWithGlobalServiceUnavailable<Operation> {\n  return withGlobalServiceUnavailable(operation);\n}\n\nconst PATH_PARAMETER_PATTERN = /\\{([^/{}]+)\\}/g;\n\nexport function operationRoutePath(\n  operation: Pick<HttpOperation, \"path\">,\n): string {\n  return operation.path.replace(PATH_PARAMETER_PATTERN, \":$1\");\n}\n\nexport function operationRequestPath<\n  Operation extends Pick<HttpOperation, \"id\" | \"params\" | \"path\">,\n>(operation: Operation, params: z.input<Operation[\"params\"]>): string {\n  const result = operation.params.safeParse(params);\n  if (!result.success) {\n    throw new TypeError(`Invalid path parameters for ${operation.id}`);\n  }\n  const values = result.data;\n  if (!isPlainObject(values)) {\n    throw new TypeError(`Invalid path parameters for ${operation.id}`);\n  }\n\n  return operation.path.replace(PATH_PARAMETER_PATTERN, (_, name: string) => {\n    const value = values[name];\n    if (typeof value !== \"string\" && typeof value !== \"number\") {\n      throw new TypeError(\n        `Invalid path parameter \"${name}\" for ${operation.id}`,\n      );\n    }\n\n    return encodeURIComponent(String(value));\n  });\n}\n\nexport function operationRequestPathWithQuery<\n  QuerySchema extends z.ZodType,\n  Operation extends Pick<HttpOperation, \"id\" | \"params\" | \"path\"> & {\n    readonly query: QuerySchema;\n  },\n>(\n  operation: Operation,\n  params: z.input<Operation[\"params\"]>,\n  query: z.input<QuerySchema>,\n): string {\n  const path = operationRequestPath(operation, params);\n  return appendOperationQuery(operation.id, operation.query, path, query);\n}\n\nexport function operationRequestPathForInput<\n  Operation extends Pick<HttpOperation, \"id\" | \"params\" | \"path\" | \"query\">,\n>(\n  operation: Operation,\n  params: z.input<Operation[\"params\"]>,\n  query: unknown,\n): string {\n  const path = operationRequestPath(operation, params);\n  if (!operation.query) {\n    if (query !== undefined) {\n      throw new TypeError(`Invalid query parameters for ${operation.id}`);\n    }\n    return path;\n  }\n\n  return appendOperationQuery(operation.id, operation.query, path, query);\n}\n\nfunction appendOperationQuery(\n  operationId: string,\n  querySchema: NonNullable<HttpOperation[\"query\"]>,\n  path: string,\n  query: unknown,\n): string {\n  const result = querySchema.safeParse(query);\n  if (!result.success || !isPlainObject(result.data)) {\n    throw new TypeError(`Invalid query parameters for ${operationId}`);\n  }\n\n  const searchParams = new URLSearchParams();\n  for (const [name, value] of Object.entries(result.data)) {\n    if (value === undefined) {\n      continue;\n    }\n    if (\n      typeof value !== \"string\" &&\n      typeof value !== \"number\" &&\n      typeof value !== \"boolean\"\n    ) {\n      throw new TypeError(\n        `Invalid query parameter \"${name}\" for ${operationId}`,\n      );\n    }\n    searchParams.set(name, String(value));\n  }\n\n  const queryString = searchParams.toString();\n  return queryString.length === 0 ? path : `${path}?${queryString}`;\n}\n"]}