@mantra-ai/core 0.1.0

package/dist/errors/schemas.d.ts

@@ -0,0 +1,304 @@
+import { z } from "zod";
+export declare const StandardErrorSchema: z.ZodObject<{
+    error: z.ZodString;
+    code: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: string;
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: string;
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>;
+export declare const Error400Schema: z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodEnum<["invalid_input", "invalid_cursor", "missing_idempotency_key", "invalid_expand_fields"]>;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "invalid_input" | "invalid_cursor" | "missing_idempotency_key" | "invalid_expand_fields";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "invalid_input" | "invalid_cursor" | "missing_idempotency_key" | "invalid_expand_fields";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>;
+export declare const Error401Schema: z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodLiteral<"unauthorized">;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "unauthorized";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "unauthorized";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>;
+export declare const Error403Schema: z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodLiteral<"license">;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "license";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "license";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>;
+export declare const Error404Schema: z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodEnum<["not_found", "work_not_found", "version_not_found"]>;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "not_found" | "work_not_found" | "version_not_found";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "not_found" | "work_not_found" | "version_not_found";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>;
+export declare const Error409Schema: z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodEnum<["not_ready", "idempotency_conflict"]>;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "idempotency_conflict" | "not_ready";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "idempotency_conflict" | "not_ready";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>;
+export declare const Error413Schema: z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodLiteral<"payload_too_large">;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "payload_too_large";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "payload_too_large";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>;
+export declare const Error500Schema: z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodLiteral<"server_error">;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "server_error";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "server_error";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>;
+export declare const ErrorResponseSchema: z.ZodUnion<[z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodEnum<["invalid_input", "invalid_cursor", "missing_idempotency_key", "invalid_expand_fields"]>;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "invalid_input" | "invalid_cursor" | "missing_idempotency_key" | "invalid_expand_fields";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "invalid_input" | "invalid_cursor" | "missing_idempotency_key" | "invalid_expand_fields";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>, z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodLiteral<"unauthorized">;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "unauthorized";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "unauthorized";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>, z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodLiteral<"license">;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "license";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "license";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>, z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodEnum<["not_found", "work_not_found", "version_not_found"]>;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "not_found" | "work_not_found" | "version_not_found";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "not_found" | "work_not_found" | "version_not_found";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>, z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodEnum<["not_ready", "idempotency_conflict"]>;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "idempotency_conflict" | "not_ready";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "idempotency_conflict" | "not_ready";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>, z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodLiteral<"payload_too_large">;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "payload_too_large";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "payload_too_large";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>, z.ZodObject<{
+    error: z.ZodString;
+    details: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodString, z.ZodNull]>>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+} & {
+    code: z.ZodLiteral<"server_error">;
+}, "strict", z.ZodTypeAny, {
+    error: string;
+    code: "server_error";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}, {
+    error: string;
+    code: "server_error";
+    details?: string | Record<string, unknown> | null | undefined;
+    correlation_id?: string | undefined;
+    endpoint?: string | undefined;
+}>]>;
+export type StandardError = z.infer<typeof StandardErrorSchema>;
+export type Error400 = z.infer<typeof Error400Schema>;
+export type Error401 = z.infer<typeof Error401Schema>;
+export type Error403 = z.infer<typeof Error403Schema>;
+export type Error404 = z.infer<typeof Error404Schema>;
+export type Error409 = z.infer<typeof Error409Schema>;
+export type Error413 = z.infer<typeof Error413Schema>;
+export type Error500 = z.infer<typeof Error500Schema>;
+export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/errors/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/errors/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAYiB,CAAC;AAGlD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;EAOzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;EAEzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;EAEzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;EAEzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;EAEzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;EAEzB,CAAC;AAGH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQ9B,CAAC;AAGH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/errors/schemas.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+// Standard error response schema - used across all endpoints
+export const StandardErrorSchema = z
+    .object({
+    error: z.string().describe("Human-readable error message"),
+    code: z.string().describe("Machine-readable error code"),
+    details: z
+        .union([z.record(z.unknown()), z.string(), z.null()])
+        .optional()
+        .describe("Optional error context"),
+    correlation_id: z.string().optional().describe("Request correlation ID"),
+    endpoint: z.string().optional().describe("Endpoint that generated the error"),
+})
+    .strict()
+    .describe("Standardized error response format");
+// Specific error schemas for different HTTP status codes
+export const Error400Schema = StandardErrorSchema.extend({
+    code: z.enum([
+        "invalid_input",
+        "invalid_cursor",
+        "missing_idempotency_key",
+        "invalid_expand_fields"
+    ]),
+});
+export const Error401Schema = StandardErrorSchema.extend({
+    code: z.literal("unauthorized"),
+});
+export const Error403Schema = StandardErrorSchema.extend({
+    code: z.literal("license"),
+});
+export const Error404Schema = StandardErrorSchema.extend({
+    code: z.enum([
+        "not_found",
+        "work_not_found",
+        "version_not_found"
+    ]),
+});
+export const Error409Schema = StandardErrorSchema.extend({
+    code: z.enum(["not_ready", "idempotency_conflict"]),
+});
+export const Error413Schema = StandardErrorSchema.extend({
+    code: z.literal("payload_too_large"),
+});
+export const Error500Schema = StandardErrorSchema.extend({
+    code: z.literal("server_error"),
+});
+// Union type for all error responses
+export const ErrorResponseSchema = z.union([
+    Error400Schema,
+    Error401Schema,
+    Error403Schema,
+    Error404Schema,
+    Error409Schema,
+    Error413Schema,
+    Error500Schema,
+]);
+//# sourceMappingURL=schemas.js.map

package/dist/errors/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/errors/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC1D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IACxD,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;SACpD,QAAQ,EAAE;SACV,QAAQ,CAAC,wBAAwB,CAAC;IACrC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IACxE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;CAC9E,CAAC;KACD,MAAM,EAAE;KACR,QAAQ,CAAC,oCAAoC,CAAC,CAAC;AAElD,yDAAyD;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QACX,eAAe;QACf,gBAAgB;QAChB,yBAAyB;QACzB,uBAAuB;KACxB,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;CAChC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QACX,WAAW;QACX,gBAAgB;QAChB,mBAAmB;KACpB,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC;CACpD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;CAChC,CAAC,CAAC;AAEH,qCAAqC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC;IACzC,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;CACf,CAAC,CAAC"}

package/dist/errors/types.d.ts

@@ -0,0 +1,30 @@
+export declare const ERROR_CODES: {
+    readonly INVALID_INPUT: "invalid_input";
+    readonly INVALID_CURSOR: "invalid_cursor";
+    readonly MISSING_IDEMPOTENCY_KEY: "missing_idempotency_key";
+    readonly INVALID_EXPAND_FIELDS: "invalid_expand_fields";
+    readonly UNAUTHORIZED: "unauthorized";
+    readonly IDEMPOTENCY_CONFLICT_CODE: "idempotency_conflict";
+    readonly LICENSE: "license";
+    readonly NOT_FOUND: "not_found";
+    readonly WORK_NOT_FOUND: "work_not_found";
+    readonly VERSION_NOT_FOUND: "version_not_found";
+    readonly NOT_READY: "not_ready";
+    readonly IDEMPOTENCY_CONFLICT: "idempotency_conflict";
+    readonly PAYLOAD_TOO_LARGE: "payload_too_large";
+    readonly SERVER_ERROR: "server_error";
+};
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+export interface StandardErrorResponse {
+    error: string;
+    code: ErrorCode;
+    details?: Record<string, unknown> | string | null;
+    correlation_id?: string;
+    endpoint?: string;
+}
+export declare function createErrorResponse(error: string, code: ErrorCode, options?: {
+    details?: Record<string, unknown> | string | null;
+    correlation_id?: string;
+    endpoint?: string;
+}): StandardErrorResponse;
+//# sourceMappingURL=types.d.ts.map

package/dist/errors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;CA4Bd,CAAC;AAGX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAGvE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,qBAAqB,CAMvB"}

package/dist/errors/types.js

@@ -0,0 +1,33 @@
+// Error code constants
+export const ERROR_CODES = {
+    // 400 Bad Request
+    INVALID_INPUT: "invalid_input",
+    INVALID_CURSOR: "invalid_cursor",
+    MISSING_IDEMPOTENCY_KEY: "missing_idempotency_key",
+    INVALID_EXPAND_FIELDS: "invalid_expand_fields",
+    // 401 Unauthorized
+    UNAUTHORIZED: "unauthorized",
+    IDEMPOTENCY_CONFLICT_CODE: "idempotency_conflict",
+    // 403 Forbidden
+    LICENSE: "license",
+    // 404 Not Found
+    NOT_FOUND: "not_found",
+    WORK_NOT_FOUND: "work_not_found",
+    VERSION_NOT_FOUND: "version_not_found",
+    // 409 Conflict
+    NOT_READY: "not_ready",
+    IDEMPOTENCY_CONFLICT: "idempotency_conflict",
+    // 413 Payload Too Large
+    PAYLOAD_TOO_LARGE: "payload_too_large",
+    // 500 Internal Server Error
+    SERVER_ERROR: "server_error",
+};
+// Helper function to create standardized error responses
+export function createErrorResponse(error, code, options) {
+    return {
+        error,
+        code,
+        ...options,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/errors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,kBAAkB;IAClB,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,uBAAuB,EAAE,yBAAyB;IAClD,qBAAqB,EAAE,uBAAuB;IAE9C,mBAAmB;IACnB,YAAY,EAAE,cAAc;IAC5B,yBAAyB,EAAE,sBAAsB;IAEjD,gBAAgB;IAChB,OAAO,EAAE,SAAS;IAElB,gBAAgB;IAChB,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,mBAAmB;IAEtC,eAAe;IACf,SAAS,EAAE,WAAW;IACtB,oBAAoB,EAAE,sBAAsB;IAE5C,wBAAwB;IACxB,iBAAiB,EAAE,mBAAmB;IAEtC,4BAA4B;IAC5B,YAAY,EAAE,cAAc;CACpB,CAAC;AAcX,yDAAyD;AACzD,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,IAAe,EACf,OAIC;IAED,OAAO;QACL,KAAK;QACL,IAAI;QACJ,GAAG,OAAO;KACX,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export * from "./errors/types";
+export * from "./errors/schemas";
+export { PipelineError, PIPELINE_ERROR_CODES } from "./works/errors";
+export type { PipelineErrorCode } from "./works/errors";
+export type { VersionSource, ActionsExternalType, ActionsIdBody, Coordinator, VersionStage, WorkRollup, UpstreamSource, AdapterResult, UpstreamError, ResolutionMeta, ResolvedIds, ResolvedMetadata, CompleteIds, FullTextType, FullTextResult, IngestWorkResult, OpenAlexIds, OpenAlexLocation, OpenAlexWork, LoggerLike, IngestWorkOptions, IngestLogger, S3RawSaved, Step, StrategyAttempt, IngestResult, FetchTextResult, FetchTextFn, StrategyContext, FullTextStrategy, PlanOptions, } from "./works/types";
+export { planSteps } from "./works/plan";
+export type { IdentifierType, ResolvedIdentifier } from "./works/id/types";
+export { normalizeDOI, detectDOI, normalizePMID, normalizePMCID, normalizeArXivId, deriveBioMedrxivDoi, } from "./works/id/normalize-internals";
+export { normalizeAndMaybeResolveToDOI } from "./works/id/normalize-ids";
+export { normalizeExternalId } from "./works/id/normalize-external-id";
+export type { ExtKey } from "./works/id/normalize-external-id";
+export { detectIdentifier } from "./works/id/detect-identifier";
+export type { DetectedIdentifier } from "./works/id/detect-identifier";
+export { parseDebugFlag } from "./works/util/debug";
+export { normalizeLicenseHref, licenseBucket } from "./works/util/license";
+export { normalizeVersionLabel } from "./works/util/version-label";
+export { pickFirstString, parseArxivIdFromUrl, parseArxivIdFromDoi, parseBiorxivMedrxivIdFromDoi, } from "./works/util/parse";
+export { createWorkId } from "./works/util/work-id";
+export { NormalizedDocSchema, SectionCategoryEnum, } from "./normalization/normalized-doc-schema";
+export type { NormalizedDoc } from "./normalization/normalized-doc-schema";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,IAAI,EACJ,eAAe,EACf,YAAY,EACZ,eAAe,EACf,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EACL,YAAY,EACZ,SAAS,EACT,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,YAAY,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+// @mantra-ai/core barrel exports
+// ── Errors ─────────────────────────────────────────────────────────
+export * from "./errors/types";
+export * from "./errors/schemas";
+// ── Works: errors ──────────────────────────────────────────────────
+export { PipelineError, PIPELINE_ERROR_CODES } from "./works/errors";
+// ── Works: plan ────────────────────────────────────────────────────
+export { planSteps } from "./works/plan";
+export { normalizeDOI, detectDOI, normalizePMID, normalizePMCID, normalizeArXivId, deriveBioMedrxivDoi, } from "./works/id/normalize-internals";
+export { normalizeAndMaybeResolveToDOI } from "./works/id/normalize-ids";
+export { normalizeExternalId } from "./works/id/normalize-external-id";
+export { detectIdentifier } from "./works/id/detect-identifier";
+// ── Works: utilities ───────────────────────────────────────────────
+export { parseDebugFlag } from "./works/util/debug";
+export { normalizeLicenseHref, licenseBucket } from "./works/util/license";
+export { normalizeVersionLabel } from "./works/util/version-label";
+export { pickFirstString, parseArxivIdFromUrl, parseArxivIdFromDoi, parseBiorxivMedrxivIdFromDoi, } from "./works/util/parse";
+export { createWorkId } from "./works/util/work-id";
+// ── Normalization ──────────────────────────────────────────────────
+export { NormalizedDocSchema, SectionCategoryEnum, } from "./normalization/normalized-doc-schema";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AAEjC,sEAAsE;AACtE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAEjC,sEAAsE;AACtE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAsCrE,sEAAsE;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC,OAAO,EACL,YAAY,EACZ,SAAS,EACT,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE,sEAAsE;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,sEAAsE;AACtE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,uCAAuC,CAAC"}

package/dist/normalization/jats/index.d.ts

@@ -0,0 +1,4 @@
+export { normalizeJatsXml, normalizeJatsToDoc } from "./normalize";
+export { finalizeNormalizedJats } from "./utils/build/finalize";
+export type { NormalizedJats, NormalizedDocEnvelope, BuildOptions, } from "./utils/types";
+//# sourceMappingURL=index.d.ts.map

package/dist/normalization/jats/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/normalization/jats/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,YAAY,GACb,MAAM,eAAe,CAAC"}

package/dist/normalization/jats/index.js

@@ -0,0 +1,3 @@
+export { normalizeJatsXml, normalizeJatsToDoc } from "./normalize";
+export { finalizeNormalizedJats } from "./utils/build/finalize";
+//# sourceMappingURL=index.js.map

package/dist/normalization/jats/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/normalization/jats/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/normalization/jats/normalize.d.ts

@@ -0,0 +1,7 @@
+import type { NormalizedJats, BuildOptions, NormalizedDocEnvelope } from "./utils/types";
+/**
+ * Entry point: normalize a JATS XML string to a simple domain JSON.
+ **/
+export declare function normalizeJatsXml(xml: string): NormalizedJats;
+export declare function normalizeJatsToDoc(xml: string, opts?: BuildOptions): NormalizedDocEnvelope;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalization/jats/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/normalization/jats/normalize.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,cAAc,EAQd,YAAY,EACZ,qBAAqB,EACtB,MAAM,eAAe,CAAC;AA6BvB;;IAEI;AAEJ,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CA6K5D;AAGD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,YAAY,GAClB,qBAAqB,CAGvB"}