@shware/http 1.2.0 → 1.2.2

package/README.md

@@ -1,6 +1,4 @@
-# Client Side Error Handling
-
-# Server Side Error Handling
+# Error Handling
 
 ## hono example
 

package/dist/__tests__/index.test.cjs

@@ -0,0 +1,27 @@
+"use strict";
+
+// src/__tests__/index.test.ts
+var import__ = require("../index.cjs");
+describe("error details", () => {
+  test("test detail list constructor", () => {
+    const details = import__.Details.new().requestInfo({ requestId: "123456", servingData: "/v1/tests" }).errorInfo({ reason: "ACCESS_DENIED" });
+    expect(details.list).toEqual([
+      {
+        type: import__.DetailType.REQUEST_INFO,
+        requestId: "123456",
+        servingData: "/v1/tests"
+      },
+      {
+        type: import__.DetailType.ERROR_INFO,
+        reason: "ACCESS_DENIED"
+      }
+    ]);
+  });
+});
+describe("error status", () => {
+  test("status type", () => {
+    const error = import__.Status.invalidArgument().error();
+    expect(error instanceof import__.StatusError).toBe(true);
+  });
+});
+//# sourceMappingURL=index.test.cjs.map

package/dist/__tests__/index.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/__tests__/index.test.ts"],"sourcesContent":["import { DetailType, Details, Status, StatusError } from '../index';\n\ndescribe('error details', () => {\n  test('test detail list constructor', () => {\n    const details = Details.new()\n      .requestInfo({ requestId: '123456', servingData: '/v1/tests' })\n      .errorInfo({ reason: 'ACCESS_DENIED' });\n\n    expect(details.list).toEqual([\n      {\n        type: DetailType.REQUEST_INFO,\n        requestId: '123456',\n        servingData: '/v1/tests',\n      },\n      {\n        type: DetailType.ERROR_INFO,\n        reason: 'ACCESS_DENIED',\n      },\n    ]);\n  });\n});\n\ndescribe('error status', () => {\n  test('status type', () => {\n    const error = Status.invalidArgument().error();\n    expect(error instanceof StatusError).toBe(true);\n  });\n});\n"],"mappings":";;;AAAA,eAAyD;AAEzD,SAAS,iBAAiB,MAAM;AAC9B,OAAK,gCAAgC,MAAM;AACzC,UAAM,UAAU,iBAAQ,IAAI,EACzB,YAAY,EAAE,WAAW,UAAU,aAAa,YAAY,CAAC,EAC7D,UAAU,EAAE,QAAQ,gBAAgB,CAAC;AAExC,WAAO,QAAQ,IAAI,EAAE,QAAQ;AAAA,MAC3B;AAAA,QACE,MAAM,oBAAW;AAAA,QACjB,WAAW;AAAA,QACX,aAAa;AAAA,MACf;AAAA,MACA;AAAA,QACE,MAAM,oBAAW;AAAA,QACjB,QAAQ;AAAA,MACV;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,MAAM;AAC7B,OAAK,eAAe,MAAM;AACxB,UAAM,QAAQ,gBAAO,gBAAgB,EAAE,MAAM;AAC7C,WAAO,iBAAiB,oBAAW,EAAE,KAAK,IAAI;AAAA,EAChD,CAAC;AACH,CAAC;","names":[]}

package/dist/__tests__/index.test.d.cts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/__tests__/index.test.mjs

@@ -0,0 +1,25 @@
+// src/__tests__/index.test.ts
+import { DetailType, Details, Status, StatusError } from "../index.mjs";
+describe("error details", () => {
+  test("test detail list constructor", () => {
+    const details = Details.new().requestInfo({ requestId: "123456", servingData: "/v1/tests" }).errorInfo({ reason: "ACCESS_DENIED" });
+    expect(details.list).toEqual([
+      {
+        type: DetailType.REQUEST_INFO,
+        requestId: "123456",
+        servingData: "/v1/tests"
+      },
+      {
+        type: DetailType.ERROR_INFO,
+        reason: "ACCESS_DENIED"
+      }
+    ]);
+  });
+});
+describe("error status", () => {
+  test("status type", () => {
+    const error = Status.invalidArgument().error();
+    expect(error instanceof StatusError).toBe(true);
+  });
+});
+//# sourceMappingURL=index.test.mjs.map

package/dist/__tests__/index.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/__tests__/index.test.ts"],"sourcesContent":["import { DetailType, Details, Status, StatusError } from '../index';\n\ndescribe('error details', () => {\n  test('test detail list constructor', () => {\n    const details = Details.new()\n      .requestInfo({ requestId: '123456', servingData: '/v1/tests' })\n      .errorInfo({ reason: 'ACCESS_DENIED' });\n\n    expect(details.list).toEqual([\n      {\n        type: DetailType.REQUEST_INFO,\n        requestId: '123456',\n        servingData: '/v1/tests',\n      },\n      {\n        type: DetailType.ERROR_INFO,\n        reason: 'ACCESS_DENIED',\n      },\n    ]);\n  });\n});\n\ndescribe('error status', () => {\n  test('status type', () => {\n    const error = Status.invalidArgument().error();\n    expect(error instanceof StatusError).toBe(true);\n  });\n});\n"],"mappings":";AAAA,SAAS,YAAY,SAAS,QAAQ,mBAAmB;AAEzD,SAAS,iBAAiB,MAAM;AAC9B,OAAK,gCAAgC,MAAM;AACzC,UAAM,UAAU,QAAQ,IAAI,EACzB,YAAY,EAAE,WAAW,UAAU,aAAa,YAAY,CAAC,EAC7D,UAAU,EAAE,QAAQ,gBAAgB,CAAC;AAExC,WAAO,QAAQ,IAAI,EAAE,QAAQ;AAAA,MAC3B;AAAA,QACE,MAAM,WAAW;AAAA,QACjB,WAAW;AAAA,QACX,aAAa;AAAA,MACf;AAAA,MACA;AAAA,QACE,MAAM,WAAW;AAAA,QACjB,QAAQ;AAAA,MACV;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,MAAM;AAC7B,OAAK,eAAe,MAAM;AACxB,UAAM,QAAQ,OAAO,gBAAgB,EAAE,MAAM;AAC7C,WAAO,iBAAiB,WAAW,EAAE,KAAK,IAAI;AAAA,EAChD,CAAC;AACH,CAAC;","names":[]}

package/dist/cache/index.cjs

@@ -0,0 +1,32 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/cache/index.ts
+var cache_exports = {};
+__export(cache_exports, {
+  cache: () => cache
+});
+module.exports = __toCommonJS(cache_exports);
+function cache(_props) {
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cache
+});
+//# sourceMappingURL=index.cjs.map

package/dist/cache/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cache/index.ts"],"sourcesContent":["interface Props<A extends unknown[], R> {\n  name: string;\n  key: (...args: A) => string;\n  fn: (...args: A) => R;\n  condition?: (...args: A) => boolean;\n}\n\nexport function cache<A extends unknown[], R>(_props: Props<A, R>) {}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOO,SAAS,MAA8B,QAAqB;AAAC;","names":[]}

package/dist/cache/index.d.cts

@@ -0,0 +1,9 @@
+interface Props<A extends unknown[], R> {
+    name: string;
+    key: (...args: A) => string;
+    fn: (...args: A) => R;
+    condition?: (...args: A) => boolean;
+}
+declare function cache<A extends unknown[], R>(_props: Props<A, R>): void;
+
+export { cache };

package/dist/cache/index.d.ts

@@ -0,0 +1,9 @@
+interface Props<A extends unknown[], R> {
+    name: string;
+    key: (...args: A) => string;
+    fn: (...args: A) => R;
+    condition?: (...args: A) => boolean;
+}
+declare function cache<A extends unknown[], R>(_props: Props<A, R>): void;
+
+export { cache };

package/dist/cache/index.mjs

@@ -0,0 +1,7 @@
+// src/cache/index.ts
+function cache(_props) {
+}
+export {
+  cache
+};
+//# sourceMappingURL=index.mjs.map

package/dist/cache/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cache/index.ts"],"sourcesContent":["interface Props<A extends unknown[], R> {\n  name: string;\n  key: (...args: A) => string;\n  fn: (...args: A) => R;\n  condition?: (...args: A) => boolean;\n}\n\nexport function cache<A extends unknown[], R>(_props: Props<A, R>) {}\n"],"mappings":";AAOO,SAAS,MAA8B,QAAqB;AAAC;","names":[]}

package/dist/error/detail.cjs

@@ -0,0 +1,93 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/error/detail.ts
+var detail_exports = {};
+__export(detail_exports, {
+  DetailType: () => DetailType,
+  Details: () => Details
+});
+module.exports = __toCommonJS(detail_exports);
+var DetailType = /* @__PURE__ */ ((DetailType2) => {
+  DetailType2["ERROR_INFO"] = "ERROR_INFO";
+  DetailType2["RETRY_INFO"] = "RETRY_INFO";
+  DetailType2["DEBUG_INFO"] = "DEBUG_INFO";
+  DetailType2["QUOTA_FAILURE"] = "QUOTA_FAILURE";
+  DetailType2["PRECONDITION_FAILURE"] = "PRECONDITION_FAILURE";
+  DetailType2["BAD_REQUEST"] = "BAD_REQUEST";
+  DetailType2["REQUEST_INFO"] = "REQUEST_INFO";
+  DetailType2["RESOURCE_INFO"] = "RESOURCE_INFO";
+  DetailType2["HELP"] = "HELP";
+  DetailType2["LOCALIZED_MESSAGE"] = "LOCALIZED_MESSAGE";
+  return DetailType2;
+})(DetailType || {});
+var Details = class _Details {
+  list = [];
+  constructor() {
+  }
+  static new() {
+    return new _Details();
+  }
+  errorInfo(detail) {
+    this.list.push({ type: "ERROR_INFO" /* ERROR_INFO */, ...detail });
+    return this;
+  }
+  retryInfo(detail) {
+    this.list.push({ type: "RETRY_INFO" /* RETRY_INFO */, ...detail });
+    return this;
+  }
+  debugInfo(detail) {
+    this.list.push({ type: "DEBUG_INFO" /* DEBUG_INFO */, ...detail });
+    return this;
+  }
+  quotaFailure(detail) {
+    this.list.push({ type: "QUOTA_FAILURE" /* QUOTA_FAILURE */, ...detail });
+    return this;
+  }
+  preconditionFailure(detail) {
+    this.list.push({ type: "PRECONDITION_FAILURE" /* PRECONDITION_FAILURE */, ...detail });
+    return this;
+  }
+  badRequest(detail) {
+    this.list.push({ type: "BAD_REQUEST" /* BAD_REQUEST */, ...detail });
+    return this;
+  }
+  requestInfo(detail) {
+    this.list.push({ type: "REQUEST_INFO" /* REQUEST_INFO */, ...detail });
+    return this;
+  }
+  resourceInfo(detail) {
+    this.list.push({ type: "RESOURCE_INFO" /* RESOURCE_INFO */, ...detail });
+    return this;
+  }
+  help(detail) {
+    this.list.push({ type: "HELP" /* HELP */, ...detail });
+    return this;
+  }
+  localizedMessage(detail) {
+    this.list.push({ type: "LOCALIZED_MESSAGE" /* LOCALIZED_MESSAGE */, ...detail });
+    return this;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DetailType,
+  Details
+});
+//# sourceMappingURL=detail.cjs.map

package/dist/error/detail.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/error/detail.ts"],"sourcesContent":["import type { ErrorReason } from './reason';\n\nexport enum DetailType {\n  ERROR_INFO = 'ERROR_INFO',\n  RETRY_INFO = 'RETRY_INFO',\n  DEBUG_INFO = 'DEBUG_INFO',\n  QUOTA_FAILURE = 'QUOTA_FAILURE',\n  PRECONDITION_FAILURE = 'PRECONDITION_FAILURE',\n  BAD_REQUEST = 'BAD_REQUEST',\n  REQUEST_INFO = 'REQUEST_INFO',\n  RESOURCE_INFO = 'RESOURCE_INFO',\n  HELP = 'HELP',\n  LOCALIZED_MESSAGE = 'LOCALIZED_MESSAGE',\n}\n\nexport interface ErrorInfo {\n  type: DetailType.ERROR_INFO;\n  reason: keyof ErrorReason | (string & {});\n  domain?: string;\n  metadata?: Record<string, string>;\n}\n\nexport interface RetryInfo {\n  type: DetailType.RETRY_INFO;\n  retryDelay: number;\n}\n\nexport interface DebugInfo {\n  type: DetailType.DEBUG_INFO;\n  stackEntries: string[];\n  detail?: string;\n}\n\nexport interface QuotaFailure {\n  type: DetailType.QUOTA_FAILURE;\n  violations: { subject: string; description: string }[];\n}\n\nexport interface PreconditionFailure {\n  type: DetailType.PRECONDITION_FAILURE;\n  violations: { type: string; subject: string; description: string }[];\n}\n\nexport interface BadRequest {\n  type: DetailType.BAD_REQUEST;\n  fieldViolations: { field: string; description: string }[];\n}\n\nexport interface RequestInfo {\n  type: DetailType.REQUEST_INFO;\n  requestId: string;\n  servingData: string;\n}\n\nexport interface ResourceInfo {\n  type: DetailType.RESOURCE_INFO;\n  resourceType: string;\n  resourceName: string;\n  owner: string;\n  description: string;\n}\n\nexport interface Help {\n  type: DetailType.HELP;\n  links: { url: string; description: string }[];\n}\n\nexport interface LocalizedMessage {\n  type: DetailType.LOCALIZED_MESSAGE;\n  locale: string;\n  message: string;\n}\n\nexport type Detail =\n  | RetryInfo\n  | DebugInfo\n  | QuotaFailure\n  | ErrorInfo\n  | PreconditionFailure\n  | BadRequest\n  | RequestInfo\n  | ResourceInfo\n  | Help\n  | LocalizedMessage;\n\n/**\n * Example usage:\n * const details = Details.new()\n *   .requestInfo({ requestId: '1234567890', servingData: '/v1/tests' })\n *   .errorInfo({ reason: 'ACCOUNT_LOCKED' });\n * */\nexport class Details {\n  readonly list: Detail[] = [];\n  private constructor() {}\n\n  static new() {\n    return new Details();\n  }\n\n  errorInfo(detail: Omit<ErrorInfo, 'type'>) {\n    this.list.push({ type: DetailType.ERROR_INFO, ...detail });\n    return this;\n  }\n\n  retryInfo(detail: Omit<RetryInfo, 'type'>) {\n    this.list.push({ type: DetailType.RETRY_INFO, ...detail });\n    return this;\n  }\n\n  debugInfo(detail: Omit<DebugInfo, 'type'>) {\n    this.list.push({ type: DetailType.DEBUG_INFO, ...detail });\n    return this;\n  }\n\n  quotaFailure(detail: Omit<QuotaFailure, 'type'>) {\n    this.list.push({ type: DetailType.QUOTA_FAILURE, ...detail });\n    return this;\n  }\n\n  preconditionFailure(detail: Omit<PreconditionFailure, 'type'>) {\n    this.list.push({ type: DetailType.PRECONDITION_FAILURE, ...detail });\n    return this;\n  }\n\n  badRequest(detail: Omit<BadRequest, 'type'>) {\n    this.list.push({ type: DetailType.BAD_REQUEST, ...detail });\n    return this;\n  }\n\n  requestInfo(detail: Omit<RequestInfo, 'type'>) {\n    this.list.push({ type: DetailType.REQUEST_INFO, ...detail });\n    return this;\n  }\n\n  resourceInfo(detail: Omit<ResourceInfo, 'type'>) {\n    this.list.push({ type: DetailType.RESOURCE_INFO, ...detail });\n    return this;\n  }\n\n  help(detail: Omit<Help, 'type'>) {\n    this.list.push({ type: DetailType.HELP, ...detail });\n    return this;\n  }\n\n  localizedMessage(detail: Omit<LocalizedMessage, 'type'>) {\n    this.list.push({ type: DetailType.LOCALIZED_MESSAGE, ...detail });\n    return this;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEO,IAAK,aAAL,kBAAKA,gBAAL;AACL,EAAAA,YAAA,gBAAa;AACb,EAAAA,YAAA,gBAAa;AACb,EAAAA,YAAA,gBAAa;AACb,EAAAA,YAAA,mBAAgB;AAChB,EAAAA,YAAA,0BAAuB;AACvB,EAAAA,YAAA,iBAAc;AACd,EAAAA,YAAA,kBAAe;AACf,EAAAA,YAAA,mBAAgB;AAChB,EAAAA,YAAA,UAAO;AACP,EAAAA,YAAA,uBAAoB;AAVV,SAAAA;AAAA,GAAA;AAyFL,IAAM,UAAN,MAAM,SAAQ;AAAA,EACV,OAAiB,CAAC;AAAA,EACnB,cAAc;AAAA,EAAC;AAAA,EAEvB,OAAO,MAAM;AACX,WAAO,IAAI,SAAQ;AAAA,EACrB;AAAA,EAEA,UAAU,QAAiC;AACzC,SAAK,KAAK,KAAK,EAAE,MAAM,+BAAuB,GAAG,OAAO,CAAC;AACzD,WAAO;AAAA,EACT;AAAA,EAEA,UAAU,QAAiC;AACzC,SAAK,KAAK,KAAK,EAAE,MAAM,+BAAuB,GAAG,OAAO,CAAC;AACzD,WAAO;AAAA,EACT;AAAA,EAEA,UAAU,QAAiC;AACzC,SAAK,KAAK,KAAK,EAAE,MAAM,+BAAuB,GAAG,OAAO,CAAC;AACzD,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,QAAoC;AAC/C,SAAK,KAAK,KAAK,EAAE,MAAM,qCAA0B,GAAG,OAAO,CAAC;AAC5D,WAAO;AAAA,EACT;AAAA,EAEA,oBAAoB,QAA2C;AAC7D,SAAK,KAAK,KAAK,EAAE,MAAM,mDAAiC,GAAG,OAAO,CAAC;AACnE,WAAO;AAAA,EACT;AAAA,EAEA,WAAW,QAAkC;AAC3C,SAAK,KAAK,KAAK,EAAE,MAAM,iCAAwB,GAAG,OAAO,CAAC;AAC1D,WAAO;AAAA,EACT;AAAA,EAEA,YAAY,QAAmC;AAC7C,SAAK,KAAK,KAAK,EAAE,MAAM,mCAAyB,GAAG,OAAO,CAAC;AAC3D,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,QAAoC;AAC/C,SAAK,KAAK,KAAK,EAAE,MAAM,qCAA0B,GAAG,OAAO,CAAC;AAC5D,WAAO;AAAA,EACT;AAAA,EAEA,KAAK,QAA4B;AAC/B,SAAK,KAAK,KAAK,EAAE,MAAM,mBAAiB,GAAG,OAAO,CAAC;AACnD,WAAO;AAAA,EACT;AAAA,EAEA,iBAAiB,QAAwC;AACvD,SAAK,KAAK,KAAK,EAAE,MAAM,6CAA8B,GAAG,OAAO,CAAC;AAChE,WAAO;AAAA,EACT;AACF;","names":["DetailType"]}

package/dist/error/detail.d.cts

@@ -0,0 +1,99 @@
+import { ErrorReason } from './reason.cjs';
+
+declare enum DetailType {
+    ERROR_INFO = "ERROR_INFO",
+    RETRY_INFO = "RETRY_INFO",
+    DEBUG_INFO = "DEBUG_INFO",
+    QUOTA_FAILURE = "QUOTA_FAILURE",
+    PRECONDITION_FAILURE = "PRECONDITION_FAILURE",
+    BAD_REQUEST = "BAD_REQUEST",
+    REQUEST_INFO = "REQUEST_INFO",
+    RESOURCE_INFO = "RESOURCE_INFO",
+    HELP = "HELP",
+    LOCALIZED_MESSAGE = "LOCALIZED_MESSAGE"
+}
+interface ErrorInfo {
+    type: DetailType.ERROR_INFO;
+    reason: keyof ErrorReason | (string & {});
+    domain?: string;
+    metadata?: Record<string, string>;
+}
+interface RetryInfo {
+    type: DetailType.RETRY_INFO;
+    retryDelay: number;
+}
+interface DebugInfo {
+    type: DetailType.DEBUG_INFO;
+    stackEntries: string[];
+    detail?: string;
+}
+interface QuotaFailure {
+    type: DetailType.QUOTA_FAILURE;
+    violations: {
+        subject: string;
+        description: string;
+    }[];
+}
+interface PreconditionFailure {
+    type: DetailType.PRECONDITION_FAILURE;
+    violations: {
+        type: string;
+        subject: string;
+        description: string;
+    }[];
+}
+interface BadRequest {
+    type: DetailType.BAD_REQUEST;
+    fieldViolations: {
+        field: string;
+        description: string;
+    }[];
+}
+interface RequestInfo {
+    type: DetailType.REQUEST_INFO;
+    requestId: string;
+    servingData: string;
+}
+interface ResourceInfo {
+    type: DetailType.RESOURCE_INFO;
+    resourceType: string;
+    resourceName: string;
+    owner: string;
+    description: string;
+}
+interface Help {
+    type: DetailType.HELP;
+    links: {
+        url: string;
+        description: string;
+    }[];
+}
+interface LocalizedMessage {
+    type: DetailType.LOCALIZED_MESSAGE;
+    locale: string;
+    message: string;
+}
+type Detail = RetryInfo | DebugInfo | QuotaFailure | ErrorInfo | PreconditionFailure | BadRequest | RequestInfo | ResourceInfo | Help | LocalizedMessage;
+/**
+ * Example usage:
+ * const details = Details.new()
+ *   .requestInfo({ requestId: '1234567890', servingData: '/v1/tests' })
+ *   .errorInfo({ reason: 'ACCOUNT_LOCKED' });
+ * */
+declare class Details {
+    readonly list: Detail[];
+    private constructor();
+    static new(): Details;
+    errorInfo(detail: Omit<ErrorInfo, 'type'>): this;
+    retryInfo(detail: Omit<RetryInfo, 'type'>): this;
+    debugInfo(detail: Omit<DebugInfo, 'type'>): this;
+    quotaFailure(detail: Omit<QuotaFailure, 'type'>): this;
+    preconditionFailure(detail: Omit<PreconditionFailure, 'type'>): this;
+    badRequest(detail: Omit<BadRequest, 'type'>): this;
+    requestInfo(detail: Omit<RequestInfo, 'type'>): this;
+    resourceInfo(detail: Omit<ResourceInfo, 'type'>): this;
+    help(detail: Omit<Help, 'type'>): this;
+    localizedMessage(detail: Omit<LocalizedMessage, 'type'>): this;
+}
+
+export { type BadRequest, type DebugInfo, type Detail, DetailType, Details, type ErrorInfo, type Help, type LocalizedMessage, type PreconditionFailure, type QuotaFailure, type RequestInfo, type ResourceInfo, type RetryInfo };

package/dist/error/detail.d.ts

@@ -0,0 +1,99 @@
+import { ErrorReason } from './reason.js';
+
+declare enum DetailType {
+    ERROR_INFO = "ERROR_INFO",
+    RETRY_INFO = "RETRY_INFO",
+    DEBUG_INFO = "DEBUG_INFO",
+    QUOTA_FAILURE = "QUOTA_FAILURE",
+    PRECONDITION_FAILURE = "PRECONDITION_FAILURE",
+    BAD_REQUEST = "BAD_REQUEST",
+    REQUEST_INFO = "REQUEST_INFO",
+    RESOURCE_INFO = "RESOURCE_INFO",
+    HELP = "HELP",
+    LOCALIZED_MESSAGE = "LOCALIZED_MESSAGE"
+}
+interface ErrorInfo {
+    type: DetailType.ERROR_INFO;
+    reason: keyof ErrorReason | (string & {});
+    domain?: string;
+    metadata?: Record<string, string>;
+}
+interface RetryInfo {
+    type: DetailType.RETRY_INFO;
+    retryDelay: number;
+}
+interface DebugInfo {
+    type: DetailType.DEBUG_INFO;
+    stackEntries: string[];
+    detail?: string;
+}
+interface QuotaFailure {
+    type: DetailType.QUOTA_FAILURE;
+    violations: {
+        subject: string;
+        description: string;
+    }[];
+}
+interface PreconditionFailure {
+    type: DetailType.PRECONDITION_FAILURE;
+    violations: {
+        type: string;
+        subject: string;
+        description: string;
+    }[];
+}
+interface BadRequest {
+    type: DetailType.BAD_REQUEST;
+    fieldViolations: {
+        field: string;
+        description: string;
+    }[];
+}
+interface RequestInfo {
+    type: DetailType.REQUEST_INFO;
+    requestId: string;
+    servingData: string;
+}
+interface ResourceInfo {
+    type: DetailType.RESOURCE_INFO;
+    resourceType: string;
+    resourceName: string;
+    owner: string;
+    description: string;
+}
+interface Help {
+    type: DetailType.HELP;
+    links: {
+        url: string;
+        description: string;
+    }[];
+}
+interface LocalizedMessage {
+    type: DetailType.LOCALIZED_MESSAGE;
+    locale: string;
+    message: string;
+}
+type Detail = RetryInfo | DebugInfo | QuotaFailure | ErrorInfo | PreconditionFailure | BadRequest | RequestInfo | ResourceInfo | Help | LocalizedMessage;
+/**
+ * Example usage:
+ * const details = Details.new()
+ *   .requestInfo({ requestId: '1234567890', servingData: '/v1/tests' })
+ *   .errorInfo({ reason: 'ACCOUNT_LOCKED' });
+ * */
+declare class Details {
+    readonly list: Detail[];
+    private constructor();
+    static new(): Details;
+    errorInfo(detail: Omit<ErrorInfo, 'type'>): this;
+    retryInfo(detail: Omit<RetryInfo, 'type'>): this;
+    debugInfo(detail: Omit<DebugInfo, 'type'>): this;
+    quotaFailure(detail: Omit<QuotaFailure, 'type'>): this;
+    preconditionFailure(detail: Omit<PreconditionFailure, 'type'>): this;
+    badRequest(detail: Omit<BadRequest, 'type'>): this;
+    requestInfo(detail: Omit<RequestInfo, 'type'>): this;
+    resourceInfo(detail: Omit<ResourceInfo, 'type'>): this;
+    help(detail: Omit<Help, 'type'>): this;
+    localizedMessage(detail: Omit<LocalizedMessage, 'type'>): this;
+}
+
+export { type BadRequest, type DebugInfo, type Detail, DetailType, Details, type ErrorInfo, type Help, type LocalizedMessage, type PreconditionFailure, type QuotaFailure, type RequestInfo, type ResourceInfo, type RetryInfo };

package/dist/error/detail.mjs

@@ -0,0 +1,67 @@
+// src/error/detail.ts
+var DetailType = /* @__PURE__ */ ((DetailType2) => {
+  DetailType2["ERROR_INFO"] = "ERROR_INFO";
+  DetailType2["RETRY_INFO"] = "RETRY_INFO";
+  DetailType2["DEBUG_INFO"] = "DEBUG_INFO";
+  DetailType2["QUOTA_FAILURE"] = "QUOTA_FAILURE";
+  DetailType2["PRECONDITION_FAILURE"] = "PRECONDITION_FAILURE";
+  DetailType2["BAD_REQUEST"] = "BAD_REQUEST";
+  DetailType2["REQUEST_INFO"] = "REQUEST_INFO";
+  DetailType2["RESOURCE_INFO"] = "RESOURCE_INFO";
+  DetailType2["HELP"] = "HELP";
+  DetailType2["LOCALIZED_MESSAGE"] = "LOCALIZED_MESSAGE";
+  return DetailType2;
+})(DetailType || {});
+var Details = class _Details {
+  list = [];
+  constructor() {
+  }
+  static new() {
+    return new _Details();
+  }
+  errorInfo(detail) {
+    this.list.push({ type: "ERROR_INFO" /* ERROR_INFO */, ...detail });
+    return this;
+  }
+  retryInfo(detail) {
+    this.list.push({ type: "RETRY_INFO" /* RETRY_INFO */, ...detail });
+    return this;
+  }
+  debugInfo(detail) {
+    this.list.push({ type: "DEBUG_INFO" /* DEBUG_INFO */, ...detail });
+    return this;
+  }
+  quotaFailure(detail) {
+    this.list.push({ type: "QUOTA_FAILURE" /* QUOTA_FAILURE */, ...detail });
+    return this;
+  }
+  preconditionFailure(detail) {
+    this.list.push({ type: "PRECONDITION_FAILURE" /* PRECONDITION_FAILURE */, ...detail });
+    return this;
+  }
+  badRequest(detail) {
+    this.list.push({ type: "BAD_REQUEST" /* BAD_REQUEST */, ...detail });
+    return this;
+  }
+  requestInfo(detail) {
+    this.list.push({ type: "REQUEST_INFO" /* REQUEST_INFO */, ...detail });
+    return this;
+  }
+  resourceInfo(detail) {
+    this.list.push({ type: "RESOURCE_INFO" /* RESOURCE_INFO */, ...detail });
+    return this;
+  }
+  help(detail) {
+    this.list.push({ type: "HELP" /* HELP */, ...detail });
+    return this;
+  }
+  localizedMessage(detail) {
+    this.list.push({ type: "LOCALIZED_MESSAGE" /* LOCALIZED_MESSAGE */, ...detail });
+    return this;
+  }
+};
+export {
+  DetailType,
+  Details
+};
+//# sourceMappingURL=detail.mjs.map

package/dist/error/detail.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/error/detail.ts"],"sourcesContent":["import type { ErrorReason } from './reason';\n\nexport enum DetailType {\n  ERROR_INFO = 'ERROR_INFO',\n  RETRY_INFO = 'RETRY_INFO',\n  DEBUG_INFO = 'DEBUG_INFO',\n  QUOTA_FAILURE = 'QUOTA_FAILURE',\n  PRECONDITION_FAILURE = 'PRECONDITION_FAILURE',\n  BAD_REQUEST = 'BAD_REQUEST',\n  REQUEST_INFO = 'REQUEST_INFO',\n  RESOURCE_INFO = 'RESOURCE_INFO',\n  HELP = 'HELP',\n  LOCALIZED_MESSAGE = 'LOCALIZED_MESSAGE',\n}\n\nexport interface ErrorInfo {\n  type: DetailType.ERROR_INFO;\n  reason: keyof ErrorReason | (string & {});\n  domain?: string;\n  metadata?: Record<string, string>;\n}\n\nexport interface RetryInfo {\n  type: DetailType.RETRY_INFO;\n  retryDelay: number;\n}\n\nexport interface DebugInfo {\n  type: DetailType.DEBUG_INFO;\n  stackEntries: string[];\n  detail?: string;\n}\n\nexport interface QuotaFailure {\n  type: DetailType.QUOTA_FAILURE;\n  violations: { subject: string; description: string }[];\n}\n\nexport interface PreconditionFailure {\n  type: DetailType.PRECONDITION_FAILURE;\n  violations: { type: string; subject: string; description: string }[];\n}\n\nexport interface BadRequest {\n  type: DetailType.BAD_REQUEST;\n  fieldViolations: { field: string; description: string }[];\n}\n\nexport interface RequestInfo {\n  type: DetailType.REQUEST_INFO;\n  requestId: string;\n  servingData: string;\n}\n\nexport interface ResourceInfo {\n  type: DetailType.RESOURCE_INFO;\n  resourceType: string;\n  resourceName: string;\n  owner: string;\n  description: string;\n}\n\nexport interface Help {\n  type: DetailType.HELP;\n  links: { url: string; description: string }[];\n}\n\nexport interface LocalizedMessage {\n  type: DetailType.LOCALIZED_MESSAGE;\n  locale: string;\n  message: string;\n}\n\nexport type Detail =\n  | RetryInfo\n  | DebugInfo\n  | QuotaFailure\n  | ErrorInfo\n  | PreconditionFailure\n  | BadRequest\n  | RequestInfo\n  | ResourceInfo\n  | Help\n  | LocalizedMessage;\n\n/**\n * Example usage:\n * const details = Details.new()\n *   .requestInfo({ requestId: '1234567890', servingData: '/v1/tests' })\n *   .errorInfo({ reason: 'ACCOUNT_LOCKED' });\n * */\nexport class Details {\n  readonly list: Detail[] = [];\n  private constructor() {}\n\n  static new() {\n    return new Details();\n  }\n\n  errorInfo(detail: Omit<ErrorInfo, 'type'>) {\n    this.list.push({ type: DetailType.ERROR_INFO, ...detail });\n    return this;\n  }\n\n  retryInfo(detail: Omit<RetryInfo, 'type'>) {\n    this.list.push({ type: DetailType.RETRY_INFO, ...detail });\n    return this;\n  }\n\n  debugInfo(detail: Omit<DebugInfo, 'type'>) {\n    this.list.push({ type: DetailType.DEBUG_INFO, ...detail });\n    return this;\n  }\n\n  quotaFailure(detail: Omit<QuotaFailure, 'type'>) {\n    this.list.push({ type: DetailType.QUOTA_FAILURE, ...detail });\n    return this;\n  }\n\n  preconditionFailure(detail: Omit<PreconditionFailure, 'type'>) {\n    this.list.push({ type: DetailType.PRECONDITION_FAILURE, ...detail });\n    return this;\n  }\n\n  badRequest(detail: Omit<BadRequest, 'type'>) {\n    this.list.push({ type: DetailType.BAD_REQUEST, ...detail });\n    return this;\n  }\n\n  requestInfo(detail: Omit<RequestInfo, 'type'>) {\n    this.list.push({ type: DetailType.REQUEST_INFO, ...detail });\n    return this;\n  }\n\n  resourceInfo(detail: Omit<ResourceInfo, 'type'>) {\n    this.list.push({ type: DetailType.RESOURCE_INFO, ...detail });\n    return this;\n  }\n\n  help(detail: Omit<Help, 'type'>) {\n    this.list.push({ type: DetailType.HELP, ...detail });\n    return this;\n  }\n\n  localizedMessage(detail: Omit<LocalizedMessage, 'type'>) {\n    this.list.push({ type: DetailType.LOCALIZED_MESSAGE, ...detail });\n    return this;\n  }\n}\n"],"mappings":";AAEO,IAAK,aAAL,kBAAKA,gBAAL;AACL,EAAAA,YAAA,gBAAa;AACb,EAAAA,YAAA,gBAAa;AACb,EAAAA,YAAA,gBAAa;AACb,EAAAA,YAAA,mBAAgB;AAChB,EAAAA,YAAA,0BAAuB;AACvB,EAAAA,YAAA,iBAAc;AACd,EAAAA,YAAA,kBAAe;AACf,EAAAA,YAAA,mBAAgB;AAChB,EAAAA,YAAA,UAAO;AACP,EAAAA,YAAA,uBAAoB;AAVV,SAAAA;AAAA,GAAA;AAyFL,IAAM,UAAN,MAAM,SAAQ;AAAA,EACV,OAAiB,CAAC;AAAA,EACnB,cAAc;AAAA,EAAC;AAAA,EAEvB,OAAO,MAAM;AACX,WAAO,IAAI,SAAQ;AAAA,EACrB;AAAA,EAEA,UAAU,QAAiC;AACzC,SAAK,KAAK,KAAK,EAAE,MAAM,+BAAuB,GAAG,OAAO,CAAC;AACzD,WAAO;AAAA,EACT;AAAA,EAEA,UAAU,QAAiC;AACzC,SAAK,KAAK,KAAK,EAAE,MAAM,+BAAuB,GAAG,OAAO,CAAC;AACzD,WAAO;AAAA,EACT;AAAA,EAEA,UAAU,QAAiC;AACzC,SAAK,KAAK,KAAK,EAAE,MAAM,+BAAuB,GAAG,OAAO,CAAC;AACzD,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,QAAoC;AAC/C,SAAK,KAAK,KAAK,EAAE,MAAM,qCAA0B,GAAG,OAAO,CAAC;AAC5D,WAAO;AAAA,EACT;AAAA,EAEA,oBAAoB,QAA2C;AAC7D,SAAK,KAAK,KAAK,EAAE,MAAM,mDAAiC,GAAG,OAAO,CAAC;AACnE,WAAO;AAAA,EACT;AAAA,EAEA,WAAW,QAAkC;AAC3C,SAAK,KAAK,KAAK,EAAE,MAAM,iCAAwB,GAAG,OAAO,CAAC;AAC1D,WAAO;AAAA,EACT;AAAA,EAEA,YAAY,QAAmC;AAC7C,SAAK,KAAK,KAAK,EAAE,MAAM,mCAAyB,GAAG,OAAO,CAAC;AAC3D,WAAO;AAAA,EACT;AAAA,EAEA,aAAa,QAAoC;AAC/C,SAAK,KAAK,KAAK,EAAE,MAAM,qCAA0B,GAAG,OAAO,CAAC;AAC5D,WAAO;AAAA,EACT;AAAA,EAEA,KAAK,QAA4B;AAC/B,SAAK,KAAK,KAAK,EAAE,MAAM,mBAAiB,GAAG,OAAO,CAAC;AACnD,WAAO;AAAA,EACT;AAAA,EAEA,iBAAiB,QAAwC;AACvD,SAAK,KAAK,KAAK,EAAE,MAAM,6CAA8B,GAAG,OAAO,CAAC;AAChE,WAAO;AAAA,EACT;AACF;","names":["DetailType"]}

package/dist/error/i18n/en-us.cjs

@@ -0,0 +1,31 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/error/i18n/en-us.ts
+var en_us_exports = {};
+__export(en_us_exports, {
+  enUS: () => enUS
+});
+module.exports = __toCommonJS(en_us_exports);
+var enUS = {};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  enUS
+});
+//# sourceMappingURL=en-us.cjs.map

package/dist/error/i18n/en-us.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/error/i18n/en-us.ts"],"sourcesContent":["export const enUS = {};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,IAAM,OAAO,CAAC;","names":[]}

package/dist/error/i18n/en-us.d.cts

@@ -0,0 +1,3 @@
+declare const enUS: {};
+
+export { enUS };

package/dist/error/i18n/en-us.d.ts

@@ -0,0 +1,3 @@
+declare const enUS: {};
+
+export { enUS };

package/dist/error/i18n/en-us.mjs

@@ -0,0 +1,6 @@
+// src/error/i18n/en-us.ts
+var enUS = {};
+export {
+  enUS
+};
+//# sourceMappingURL=en-us.mjs.map

package/dist/error/i18n/en-us.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/error/i18n/en-us.ts"],"sourcesContent":["export const enUS = {};\n"],"mappings":";AAAO,IAAM,OAAO,CAAC;","names":[]}

package/dist/error/index.cjs

@@ -0,0 +1,63 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/error/index.ts
+var error_exports = {};
+__export(error_exports, {
+  CheckoutCreateError: () => CheckoutCreateError,
+  LoginCanceledError: () => LoginCanceledError,
+  LoginTimeoutError: () => LoginTimeoutError,
+  PurchaseError: () => PurchaseError
+});
+module.exports = __toCommonJS(error_exports);
+var LoginTimeoutError = class extends Error {
+  constructor(timeout) {
+    super(`Login timeout after ${timeout}ms`);
+    this.name = "LoginTimeoutError";
+  }
+};
+var LoginCanceledError = class extends Error {
+  constructor() {
+    super("Login canceled by user");
+    this.name = "LoginCanceledError";
+  }
+};
+var CheckoutCreateError = class extends Error {
+  constructor() {
+    super("Failed to create checkout session");
+    this.name = "SessionCreateError";
+  }
+};
+var PurchaseError = /* @__PURE__ */ ((PurchaseError2) => {
+  PurchaseError2["LOGIN_TIMEOUT"] = "LOGIN_TIMEOUT";
+  PurchaseError2["LOGIN_CANCELED"] = "LOGIN_CANCELED";
+  PurchaseError2["CHECKOUT_CANCELED"] = "CHECKOUT_CANCELED";
+  PurchaseError2["CHECKOUT_CREATE_FAILED"] = "CHECKOUT_CREATE_FAILED";
+  PurchaseError2["CHECKOUT_SESSION_ID_NOT_FOUND"] = "CHECKOUT_SESSION_ID_NOT_FOUND";
+  PurchaseError2["UNKNOWN"] = "UNKNOWN";
+  return PurchaseError2;
+})(PurchaseError || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CheckoutCreateError,
+  LoginCanceledError,
+  LoginTimeoutError,
+  PurchaseError
+});
+//# sourceMappingURL=index.cjs.map