@miaixz/sdk 0.5.0

package/dist/types/api.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Identifies a Miaixz domain resource.
+ *
+ * @public
+ */
+export type MiaixzIdentifier = string;
+/**
+ * Represents an ISO 8601 date-time string.
+ *
+ * @public
+ */
+export type MiaixzIsoDateTime = string;
+/**
+ * Describes the identity shared by Miaixz domain entities.
+ *
+ * @public
+ */
+export interface MiaixzEntity {
+    /**
+     * Unique identifier of the entity.
+     */
+    id: MiaixzIdentifier;
+}
+/**
+ * Describes an entity that records creation and update times.
+ *
+ * @public
+ */
+export interface MiaixzTimestampedEntity extends MiaixzEntity {
+    /**
+     * Time at which the entity was created.
+     */
+    createdAt: MiaixzIsoDateTime;
+    /**
+     * Time at which the entity was last updated.
+     */
+    updatedAt: MiaixzIsoDateTime;
+}
+/**
+ * Describes the standard envelope returned by Miaixz APIs.
+ *
+ * @typeParam T - Type of the successful response payload.
+ * @public
+ */
+export interface MiaixzApiEnvelope<T> {
+    /**
+     * Result code, where zero represents a successful response.
+     */
+    readonly errcode: string | number;
+    /**
+     * Human-readable result message supplied by the API.
+     */
+    readonly errmsg: string;
+    /**
+     * Payload returned by the API.
+     */
+    readonly data: T;
+}
+/**
+ * Describes normalized information about an API failure.
+ *
+ * @public
+ */
+export interface MiaixzApiProblem {
+    /**
+     * Optional machine-readable error code.
+     */
+    code?: string;
+    /**
+     * Human-readable error message.
+     */
+    message: string;
+    /**
+     * Optional request identifier used for diagnostics.
+     */
+    requestId?: string;
+    /**
+     * Optional provider-specific error details.
+     */
+    details?: unknown;
+}
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEvC;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,EAAE,gBAAgB,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D;;OAEG;IACH,SAAS,EAAE,iBAAiB,CAAC;IAE7B;;OAEG;IACH,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/types/api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.js.map

package/dist/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Identifies a Miaixz domain resource.\n *\n * @public\n */\nexport type MiaixzIdentifier = string;\n\n/**\n * Represents an ISO 8601 date-time string.\n *\n * @public\n */\nexport type MiaixzIsoDateTime = string;\n\n/**\n * Describes the identity shared by Miaixz domain entities.\n *\n * @public\n */\nexport interface MiaixzEntity {\n  /**\n   * Unique identifier of the entity.\n   */\n  id: MiaixzIdentifier;\n}\n\n/**\n * Describes an entity that records creation and update times.\n *\n * @public\n */\nexport interface MiaixzTimestampedEntity extends MiaixzEntity {\n  /**\n   * Time at which the entity was created.\n   */\n  createdAt: MiaixzIsoDateTime;\n\n  /**\n   * Time at which the entity was last updated.\n   */\n  updatedAt: MiaixzIsoDateTime;\n}\n\n/**\n * Describes the standard envelope returned by Miaixz APIs.\n *\n * @typeParam T - Type of the successful response payload.\n * @public\n */\nexport interface MiaixzApiEnvelope<T> {\n  /**\n   * Result code, where zero represents a successful response.\n   */\n  readonly errcode: string | number;\n\n  /**\n   * Human-readable result message supplied by the API.\n   */\n  readonly errmsg: string;\n\n  /**\n   * Payload returned by the API.\n   */\n  readonly data: T;\n}\n\n/**\n * Describes normalized information about an API failure.\n *\n * @public\n */\nexport interface MiaixzApiProblem {\n  /**\n   * Optional machine-readable error code.\n   */\n  code?: string;\n\n  /**\n   * Human-readable error message.\n   */\n  message: string;\n\n  /**\n   * Optional request identifier used for diagnostics.\n   */\n  requestId?: string;\n\n  /**\n   * Optional provider-specific error details.\n   */\n  details?: unknown;\n}\n"]}

package/dist/types/appearance.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Lists the color modes supported by the Miaixz interface.
+ *
+ * @public
+ */
+export declare const miaixzColorModes: readonly ["light", "dark", "system"];
+/**
+ * Lists the interface density modes supported by Miaixz.
+ *
+ * @public
+ */
+export declare const miaixzDensities: readonly ["compact", "standard", "comfortable"];
+/**
+ * Represents a configured Miaixz color mode.
+ *
+ * @public
+ */
+export type MiaixzColorMode = (typeof miaixzColorModes)[number];
+/**
+ * Represents a concrete color mode after resolving system preference.
+ *
+ * @public
+ */
+export type MiaixzResolvedColorMode = Exclude<MiaixzColorMode, "system">;
+/**
+ * Represents a supported Miaixz interface density.
+ *
+ * @public
+ */
+export type MiaixzDensity = (typeof miaixzDensities)[number];
+/**
+ * Lists color tokens that may be customized through appearance settings.
+ *
+ * @public
+ */
+export declare const miaixzThemeColorTokens: readonly ["brand", "on-brand", "background", "surface", "surface-secondary", "surface-hover", "surface-active", "surface-selected", "text-primary", "text-secondary", "text-muted", "text-disabled", "text-inverse", "border", "border-strong", "focus", "success", "success-soft", "warning", "warning-soft", "danger", "danger-soft", "info", "info-soft", "backdrop", "shadow", "shadow-strong", "selection"];
+/**
+ * Represents the name of a customizable Miaixz theme color token.
+ *
+ * @public
+ */
+export type MiaixzThemeColorToken = (typeof miaixzThemeColorTokens)[number];
+/**
+ * Maps theme color tokens to valid CSS color values.
+ *
+ * @public
+ */
+export type MiaixzThemeColors = Partial<Readonly<Record<MiaixzThemeColorToken, string>>>;
+/**
+ * Configures visual preferences shared across Miaixz applications.
+ *
+ * @public
+ */
+export interface MiaixzAppearanceSettings {
+    /**
+     * Preferred light, dark, or system color mode.
+     */
+    readonly colorMode: MiaixzColorMode;
+    /**
+     * Preferred interface density.
+     */
+    readonly density: MiaixzDensity;
+    /**
+     * Optional theme color overrides keyed by semantic token.
+     */
+    readonly colors?: MiaixzThemeColors;
+}
+/**
+ * Wraps appearance settings for versioned persistence and event transport.
+ *
+ * @public
+ */
+export interface MiaixzAppearancePayload {
+    /**
+     * Identifies the frozen appearance payload schema.
+     *
+     * @defaultValue 1
+     */
+    readonly schemaVersion: 1;
+    /**
+     * Contains the validated appearance settings snapshot.
+     */
+    readonly value: MiaixzAppearanceSettings;
+}
+//# sourceMappingURL=appearance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"appearance.d.ts","sourceRoot":"","sources":["../../src/types/appearance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,YAAI,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,eAAe,YAAI,SAAS,EAAE,UAAU,EAAE,aAAa,CAAU,CAAC;AAE/E;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,YACjC,OAAO,EACP,UAAU,EACV,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,QAAQ,EACR,eAAe,EACf,OAAO,EACP,SAAS,EACT,cAAc,EACd,SAAS,EACT,cAAc,EACd,QAAQ,EACR,aAAa,EACb,MAAM,EACN,WAAW,EACX,UAAU,EACV,QAAQ,EACR,eAAe,EACf,WAAW,CACH,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAEzF;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;CAC1C"}

package/dist/types/appearance.js

@@ -0,0 +1,48 @@
+/**
+ * Lists the color modes supported by the Miaixz interface.
+ *
+ * @public
+ */
+export const miaixzColorModes = ["light", "dark", "system"];
+/**
+ * Lists the interface density modes supported by Miaixz.
+ *
+ * @public
+ */
+export const miaixzDensities = ["compact", "standard", "comfortable"];
+/**
+ * Lists color tokens that may be customized through appearance settings.
+ *
+ * @public
+ */
+export const miaixzThemeColorTokens = [
+    "brand",
+    "on-brand",
+    "background",
+    "surface",
+    "surface-secondary",
+    "surface-hover",
+    "surface-active",
+    "surface-selected",
+    "text-primary",
+    "text-secondary",
+    "text-muted",
+    "text-disabled",
+    "text-inverse",
+    "border",
+    "border-strong",
+    "focus",
+    "success",
+    "success-soft",
+    "warning",
+    "warning-soft",
+    "danger",
+    "danger-soft",
+    "info",
+    "info-soft",
+    "backdrop",
+    "shadow",
+    "shadow-strong",
+    "selection",
+];
+//# sourceMappingURL=appearance.js.map

package/dist/types/appearance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appearance.js","sourceRoot":"","sources":["../../src/types/appearance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAErE;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,aAAa,CAAU,CAAC;AAuB/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,OAAO;IACP,UAAU;IACV,YAAY;IACZ,SAAS;IACT,mBAAmB;IACnB,eAAe;IACf,gBAAgB;IAChB,kBAAkB;IAClB,cAAc;IACd,gBAAgB;IAChB,YAAY;IACZ,eAAe;IACf,cAAc;IACd,QAAQ;IACR,eAAe;IACf,OAAO;IACP,SAAS;IACT,cAAc;IACd,SAAS;IACT,cAAc;IACd,QAAQ;IACR,aAAa;IACb,MAAM;IACN,WAAW;IACX,UAAU;IACV,QAAQ;IACR,eAAe;IACf,WAAW;CACH,CAAC","sourcesContent":["/**\n * Lists the color modes supported by the Miaixz interface.\n *\n * @public\n */\nexport const miaixzColorModes = [\"light\", \"dark\", \"system\"] as const;\n\n/**\n * Lists the interface density modes supported by Miaixz.\n *\n * @public\n */\nexport const miaixzDensities = [\"compact\", \"standard\", \"comfortable\"] as const;\n\n/**\n * Represents a configured Miaixz color mode.\n *\n * @public\n */\nexport type MiaixzColorMode = (typeof miaixzColorModes)[number];\n\n/**\n * Represents a concrete color mode after resolving system preference.\n *\n * @public\n */\nexport type MiaixzResolvedColorMode = Exclude<MiaixzColorMode, \"system\">;\n\n/**\n * Represents a supported Miaixz interface density.\n *\n * @public\n */\nexport type MiaixzDensity = (typeof miaixzDensities)[number];\n\n/**\n * Lists color tokens that may be customized through appearance settings.\n *\n * @public\n */\nexport const miaixzThemeColorTokens = [\n  \"brand\",\n  \"on-brand\",\n  \"background\",\n  \"surface\",\n  \"surface-secondary\",\n  \"surface-hover\",\n  \"surface-active\",\n  \"surface-selected\",\n  \"text-primary\",\n  \"text-secondary\",\n  \"text-muted\",\n  \"text-disabled\",\n  \"text-inverse\",\n  \"border\",\n  \"border-strong\",\n  \"focus\",\n  \"success\",\n  \"success-soft\",\n  \"warning\",\n  \"warning-soft\",\n  \"danger\",\n  \"danger-soft\",\n  \"info\",\n  \"info-soft\",\n  \"backdrop\",\n  \"shadow\",\n  \"shadow-strong\",\n  \"selection\",\n] as const;\n\n/**\n * Represents the name of a customizable Miaixz theme color token.\n *\n * @public\n */\nexport type MiaixzThemeColorToken = (typeof miaixzThemeColorTokens)[number];\n\n/**\n * Maps theme color tokens to valid CSS color values.\n *\n * @public\n */\nexport type MiaixzThemeColors = Partial<Readonly<Record<MiaixzThemeColorToken, string>>>;\n\n/**\n * Configures visual preferences shared across Miaixz applications.\n *\n * @public\n */\nexport interface MiaixzAppearanceSettings {\n  /**\n   * Preferred light, dark, or system color mode.\n   */\n  readonly colorMode: MiaixzColorMode;\n\n  /**\n   * Preferred interface density.\n   */\n  readonly density: MiaixzDensity;\n\n  /**\n   * Optional theme color overrides keyed by semantic token.\n   */\n  readonly colors?: MiaixzThemeColors;\n}\n\n/**\n * Wraps appearance settings for versioned persistence and event transport.\n *\n * @public\n */\nexport interface MiaixzAppearancePayload {\n  /**\n   * Identifies the frozen appearance payload schema.\n   *\n   * @defaultValue 1\n   */\n  readonly schemaVersion: 1;\n\n  /**\n   * Contains the validated appearance settings snapshot.\n   */\n  readonly value: MiaixzAppearanceSettings;\n}\n"]}

package/dist/types/config.d.ts

@@ -0,0 +1,49 @@
+import type { MiaixzAppearanceSettings } from "./appearance.js";
+/**
+ * Represents an execution environment recognized by the SDK.
+ *
+ * @public
+ */
+export type MiaixzEnvironment = "development" | "test" | "staging" | "production";
+/**
+ * Represents a serializable feature-flag value.
+ *
+ * @public
+ */
+export type MiaixzFeatureValue = boolean | string | number;
+/**
+ * Configures a Miaixz SDK instance.
+ *
+ * @public
+ */
+export interface MiaixzSdkConfig {
+    /**
+     * Base URL used for API requests.
+     */
+    apiBaseUrl: string;
+    /**
+     * Environment in which the SDK is running.
+     */
+    environment: MiaixzEnvironment;
+    /**
+     * Optional application release identifier included in diagnostics.
+     */
+    release?: string;
+    /**
+     * Optional service names mapped to service base URLs.
+     */
+    services?: Readonly<Record<string, string>>;
+    /**
+     * Optional feature flags supplied by the host application.
+     */
+    features?: Readonly<Record<string, MiaixzFeatureValue>>;
+    /**
+     * Optional global appearance preferences.
+     */
+    appearance?: MiaixzAppearanceSettings;
+    /**
+     * Optional default request timeout in milliseconds.
+     */
+    requestTimeoutMs?: number;
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;AAElF;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,EAAE,iBAAiB,CAAC;IAE/B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAExD;;OAEG;IACH,UAAU,CAAC,EAAE,wBAAwB,CAAC;IAEtC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/types/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"","sourcesContent":["import type { MiaixzAppearanceSettings } from \"./appearance.js\";\n\n/**\n * Represents an execution environment recognized by the SDK.\n *\n * @public\n */\nexport type MiaixzEnvironment = \"development\" | \"test\" | \"staging\" | \"production\";\n\n/**\n * Represents a serializable feature-flag value.\n *\n * @public\n */\nexport type MiaixzFeatureValue = boolean | string | number;\n\n/**\n * Configures a Miaixz SDK instance.\n *\n * @public\n */\nexport interface MiaixzSdkConfig {\n  /**\n   * Base URL used for API requests.\n   */\n  apiBaseUrl: string;\n\n  /**\n   * Environment in which the SDK is running.\n   */\n  environment: MiaixzEnvironment;\n\n  /**\n   * Optional application release identifier included in diagnostics.\n   */\n  release?: string;\n\n  /**\n   * Optional service names mapped to service base URLs.\n   */\n  services?: Readonly<Record<string, string>>;\n\n  /**\n   * Optional feature flags supplied by the host application.\n   */\n  features?: Readonly<Record<string, MiaixzFeatureValue>>;\n\n  /**\n   * Optional global appearance preferences.\n   */\n  appearance?: MiaixzAppearanceSettings;\n\n  /**\n   * Optional default request timeout in milliseconds.\n   */\n  requestTimeoutMs?: number;\n}\n"]}

package/dist/types/context.d.ts

@@ -0,0 +1,41 @@
+import type { MiaixzIdentifier } from "./api.js";
+/**
+ * Describes the execution context propagated across Miaixz services.
+ *
+ * @public
+ */
+export interface MiaixzRuntimeContext {
+    /**
+     * Identifier of the authenticated user.
+     */
+    userId?: MiaixzIdentifier;
+    /**
+     * Security and data-isolation boundary for every tenant-owned resource.
+     */
+    tenantId?: MiaixzIdentifier;
+    /**
+     * Optional organization selected inside the active tenant.
+     */
+    organizationId?: MiaixzIdentifier;
+    /**
+     * Optional department selected inside the active organization.
+     */
+    departmentId?: MiaixzIdentifier;
+    /**
+     * Optional workspace selected by the user.
+     */
+    spaceId?: MiaixzIdentifier;
+    /**
+     * Locale used for translated messages and regional formatting.
+     */
+    locale?: string;
+    /**
+     * IANA timezone used for date and time presentation.
+     */
+    timezone?: string;
+    /**
+     * Optional trace identifier propagated for diagnostics.
+     */
+    traceId?: string;
+}
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;OAEG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAElC;;OAEG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAEhC;;OAEG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAE3B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/types/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"","sourcesContent":["import type { MiaixzIdentifier } from \"./api.js\";\n\n/**\n * Describes the execution context propagated across Miaixz services.\n *\n * @public\n */\nexport interface MiaixzRuntimeContext {\n  /**\n   * Identifier of the authenticated user.\n   */\n  userId?: MiaixzIdentifier;\n\n  /**\n   * Security and data-isolation boundary for every tenant-owned resource.\n   */\n  tenantId?: MiaixzIdentifier;\n  /**\n   * Optional organization selected inside the active tenant.\n   */\n  organizationId?: MiaixzIdentifier;\n\n  /**\n   * Optional department selected inside the active organization.\n   */\n  departmentId?: MiaixzIdentifier;\n\n  /**\n   * Optional workspace selected by the user.\n   */\n  spaceId?: MiaixzIdentifier;\n\n  /**\n   * Locale used for translated messages and regional formatting.\n   */\n  locale?: string;\n\n  /**\n   * IANA timezone used for date and time presentation.\n   */\n  timezone?: string;\n\n  /**\n   * Optional trace identifier propagated for diagnostics.\n   */\n  traceId?: string;\n}\n"]}

package/dist/types/file.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Describes a file managed by a Miaixz service.
+ *
+ * @public
+ */
+export interface MiaixzFileDescriptor {
+    /**
+     * Unique identifier of the file.
+     */
+    id: string;
+    /**
+     * Original or display name of the file.
+     */
+    name: string;
+    /**
+     * File size in bytes.
+     */
+    size: number;
+    /**
+     * Optional media type of the file content.
+     */
+    contentType?: string;
+    /**
+     * Optional checksum used to verify file integrity.
+     */
+    checksum?: string;
+    /**
+     * Optional URL from which the file can be downloaded.
+     */
+    downloadUrl?: string;
+    /**
+     * Optional ISO 8601 creation time.
+     */
+    createdAt?: string;
+}
+/**
+ * Describes the files returned by an upload operation.
+ *
+ * @typeParam TFile - Concrete descriptor type returned for each uploaded file.
+ * @public
+ */
+export interface MiaixzUploadResult<TFile extends MiaixzFileDescriptor = MiaixzFileDescriptor> {
+    /**
+     * Immutable collection of uploaded files.
+     */
+    files: readonly TFile[];
+}
+//# sourceMappingURL=file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/types/file.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,SAAS,oBAAoB,GAAG,oBAAoB;IAC3F;;OAEG;IACH,KAAK,EAAE,SAAS,KAAK,EAAE,CAAC;CACzB"}

package/dist/types/file.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file.js.map

package/dist/types/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/types/file.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Describes a file managed by a Miaixz service.\n *\n * @public\n */\nexport interface MiaixzFileDescriptor {\n  /**\n   * Unique identifier of the file.\n   */\n  id: string;\n\n  /**\n   * Original or display name of the file.\n   */\n  name: string;\n\n  /**\n   * File size in bytes.\n   */\n  size: number;\n\n  /**\n   * Optional media type of the file content.\n   */\n  contentType?: string;\n\n  /**\n   * Optional checksum used to verify file integrity.\n   */\n  checksum?: string;\n\n  /**\n   * Optional URL from which the file can be downloaded.\n   */\n  downloadUrl?: string;\n\n  /**\n   * Optional ISO 8601 creation time.\n   */\n  createdAt?: string;\n}\n\n/**\n * Describes the files returned by an upload operation.\n *\n * @typeParam TFile - Concrete descriptor type returned for each uploaded file.\n * @public\n */\nexport interface MiaixzUploadResult<TFile extends MiaixzFileDescriptor = MiaixzFileDescriptor> {\n  /**\n   * Immutable collection of uploaded files.\n   */\n  files: readonly TFile[];\n}\n"]}

package/dist/types/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./api.js";
+export * from "./appearance.js";
+export * from "./config.js";
+export * from "./context.js";
+export * from "./file.js";
+export * from "./organization.js";
+export * from "./pagination.js";
+export * from "./permissions.js";
+export * from "./space.js";
+export * from "./tenant.js";
+export * from "./user.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,12 @@
+export * from "./api.js";
+export * from "./appearance.js";
+export * from "./config.js";
+export * from "./context.js";
+export * from "./file.js";
+export * from "./organization.js";
+export * from "./pagination.js";
+export * from "./permissions.js";
+export * from "./space.js";
+export * from "./tenant.js";
+export * from "./user.js";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC","sourcesContent":["export * from \"./api.js\";\nexport * from \"./appearance.js\";\nexport * from \"./config.js\";\nexport * from \"./context.js\";\nexport * from \"./file.js\";\nexport * from \"./organization.js\";\nexport * from \"./pagination.js\";\nexport * from \"./permissions.js\";\nexport * from \"./space.js\";\nexport * from \"./tenant.js\";\nexport * from \"./user.js\";\n"]}

package/dist/types/organization.d.ts

@@ -0,0 +1,56 @@
+import type { MiaixzIdentifier } from "./api.js";
+/**
+ * Describes an organization within a tenant.
+ *
+ * @public
+ */
+export interface MiaixzOrganizationSummary {
+    /**
+     * Unique identifier of the organization.
+     */
+    id: MiaixzIdentifier;
+    /**
+     * Identifier of the tenant that owns the organization.
+     */
+    tenantId: MiaixzIdentifier;
+    /**
+     * Display name of the organization.
+     */
+    name: string;
+    /**
+     * Optional human-readable organization code.
+     */
+    code?: string;
+}
+/**
+ * Describes a department within an organization.
+ *
+ * @public
+ */
+export interface MiaixzDepartmentSummary {
+    /**
+     * Unique identifier of the department.
+     */
+    id: MiaixzIdentifier;
+    /**
+     * Identifier of the tenant that owns the department.
+     */
+    tenantId: MiaixzIdentifier;
+    /**
+     * Identifier of the organization that contains the department.
+     */
+    organizationId: MiaixzIdentifier;
+    /**
+     * Display name of the department.
+     */
+    name: string;
+    /**
+     * Optional human-readable department code.
+     */
+    code?: string;
+    /**
+     * Optional identifier of the parent department.
+     */
+    parentId?: MiaixzIdentifier;
+}
+//# sourceMappingURL=organization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"organization.d.ts","sourceRoot":"","sources":["../../src/types/organization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,EAAE,EAAE,gBAAgB,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,gBAAgB,CAAC;IAE3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,EAAE,EAAE,gBAAgB,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,gBAAgB,CAAC;IAE3B;;OAEG;IACH,cAAc,EAAE,gBAAgB,CAAC;IAEjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B"}

package/dist/types/organization.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=organization.js.map

package/dist/types/organization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization.js","sourceRoot":"","sources":["../../src/types/organization.ts"],"names":[],"mappings":"","sourcesContent":["import type { MiaixzIdentifier } from \"./api.js\";\n\n/**\n * Describes an organization within a tenant.\n *\n * @public\n */\nexport interface MiaixzOrganizationSummary {\n  /**\n   * Unique identifier of the organization.\n   */\n  id: MiaixzIdentifier;\n\n  /**\n   * Identifier of the tenant that owns the organization.\n   */\n  tenantId: MiaixzIdentifier;\n\n  /**\n   * Display name of the organization.\n   */\n  name: string;\n\n  /**\n   * Optional human-readable organization code.\n   */\n  code?: string;\n}\n\n/**\n * Describes a department within an organization.\n *\n * @public\n */\nexport interface MiaixzDepartmentSummary {\n  /**\n   * Unique identifier of the department.\n   */\n  id: MiaixzIdentifier;\n\n  /**\n   * Identifier of the tenant that owns the department.\n   */\n  tenantId: MiaixzIdentifier;\n\n  /**\n   * Identifier of the organization that contains the department.\n   */\n  organizationId: MiaixzIdentifier;\n\n  /**\n   * Display name of the department.\n   */\n  name: string;\n\n  /**\n   * Optional human-readable department code.\n   */\n  code?: string;\n\n  /**\n   * Optional identifier of the parent department.\n   */\n  parentId?: MiaixzIdentifier;\n}\n"]}

package/dist/types/pagination.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Describes pagination metadata returned by a list operation.
+ *
+ * @public
+ */
+export interface MiaixzPagination {
+    /**
+     * One-based current page number.
+     */
+    page: number;
+    /**
+     * Maximum number of items requested per page.
+     */
+    pageSize: number;
+    /**
+     * Total number of items available across all pages.
+     */
+    total: number;
+}
+/**
+ * Describes optional pagination parameters for a list request.
+ *
+ * @public
+ */
+export interface MiaixzPageQuery {
+    /**
+     * Optional one-based page number to request.
+     */
+    page?: number;
+    /**
+     * Optional maximum number of items to request per page.
+     */
+    pageSize?: number;
+}
+/**
+ * Describes a page of immutable result items and its pagination metadata.
+ *
+ * @typeParam T - Type of each result item.
+ * @public
+ */
+export interface MiaixzPage<T> extends MiaixzPagination {
+    /**
+     * Immutable items contained in the current page.
+     */
+    items: readonly T[];
+}
+/**
+ * Calculates the number of pages, returning zero when the page size is invalid.
+ *
+ * @param pagination - Pagination metadata used for the calculation.
+ * @returns Total page count rounded up to include a partial final page.
+ * @public
+ */
+export declare function getMiaixzPageCount(pagination: MiaixzPagination): number;
+//# sourceMappingURL=pagination.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/types/pagination.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,CAAE,SAAQ,gBAAgB;IACrD;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAGvE"}

package/dist/types/pagination.js

@@ -0,0 +1,13 @@
+/**
+ * Calculates the number of pages, returning zero when the page size is invalid.
+ *
+ * @param pagination - Pagination metadata used for the calculation.
+ * @returns Total page count rounded up to include a partial final page.
+ * @public
+ */
+export function getMiaixzPageCount(pagination) {
+    if (pagination.pageSize <= 0)
+        return 0;
+    return Math.ceil(Math.max(0, pagination.total) / pagination.pageSize);
+}
+//# sourceMappingURL=pagination.js.map

package/dist/types/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/types/pagination.ts"],"names":[],"mappings":"AAoDA;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA4B;IAC7D,IAAI,UAAU,CAAC,QAAQ,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;AACxE,CAAC","sourcesContent":["/**\n * Describes pagination metadata returned by a list operation.\n *\n * @public\n */\nexport interface MiaixzPagination {\n  /**\n   * One-based current page number.\n   */\n  page: number;\n\n  /**\n   * Maximum number of items requested per page.\n   */\n  pageSize: number;\n\n  /**\n   * Total number of items available across all pages.\n   */\n  total: number;\n}\n\n/**\n * Describes optional pagination parameters for a list request.\n *\n * @public\n */\nexport interface MiaixzPageQuery {\n  /**\n   * Optional one-based page number to request.\n   */\n  page?: number;\n\n  /**\n   * Optional maximum number of items to request per page.\n   */\n  pageSize?: number;\n}\n\n/**\n * Describes a page of immutable result items and its pagination metadata.\n *\n * @typeParam T - Type of each result item.\n * @public\n */\nexport interface MiaixzPage<T> extends MiaixzPagination {\n  /**\n   * Immutable items contained in the current page.\n   */\n  items: readonly T[];\n}\n\n/**\n * Calculates the number of pages, returning zero when the page size is invalid.\n *\n * @param pagination - Pagination metadata used for the calculation.\n * @returns Total page count rounded up to include a partial final page.\n * @public\n */\nexport function getMiaixzPageCount(pagination: MiaixzPagination): number {\n  if (pagination.pageSize <= 0) return 0;\n  return Math.ceil(Math.max(0, pagination.total) / pagination.pageSize);\n}\n"]}

package/dist/types/permissions.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Identifies a permission granted by the Miaixz authorization model.
+ *
+ * @public
+ */
+export type MiaixzPermissionCode = string;
+/**
+ * Describes resolved permissions and roles for the active context.
+ *
+ * @public
+ */
+export interface MiaixzPermissionSnapshot {
+    /**
+     * Immutable permission codes explicitly granted to the principal.
+     */
+    allowed: readonly MiaixzPermissionCode[];
+    /**
+     * Optional immutable permission codes explicitly denied to the principal.
+     */
+    denied?: readonly MiaixzPermissionCode[];
+    /**
+     * Optional immutable role identifiers assigned to the principal.
+     */
+    roles?: readonly string[];
+}
+//# sourceMappingURL=permissions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/types/permissions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAEzC;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAEzC;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B"}

package/dist/types/permissions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=permissions.js.map

package/dist/types/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/types/permissions.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Identifies a permission granted by the Miaixz authorization model.\n *\n * @public\n */\nexport type MiaixzPermissionCode = string;\n\n/**\n * Describes resolved permissions and roles for the active context.\n *\n * @public\n */\nexport interface MiaixzPermissionSnapshot {\n  /**\n   * Immutable permission codes explicitly granted to the principal.\n   */\n  allowed: readonly MiaixzPermissionCode[];\n\n  /**\n   * Optional immutable permission codes explicitly denied to the principal.\n   */\n  denied?: readonly MiaixzPermissionCode[];\n\n  /**\n   * Optional immutable role identifiers assigned to the principal.\n   */\n  roles?: readonly string[];\n}\n"]}