{
  "id": "@typed/async-data#Failure",
  "canonicalId": "@typed/async-data#Failure",
  "symbol": {
    "id": "@typed/async-data#Failure",
    "packageName": "@typed/async-data",
    "moduleName": ".",
    "exportName": "Failure",
    "kind": "interface",
    "signatures": [
      "export interface Failure<E> {\n    readonly _tag: \"Failure\";\n    readonly cause: Cause.Cause<E>;\n    readonly progress?: Progress | undefined;\n}"
    ],
    "summary": "Represents an Effect failure, optionally while a retry refreshes it.",
    "sections": {
      "Why": "Retaining the complete Effect `Cause` preserves typed errors, defects, and interruption instead of flattening failure detail.",
      "Ownership and lifetime": "This plain wrapper acquires no resources; its `Cause` is persistent, but the wrapper itself is not frozen.",
      "Property: _tag": "The discriminant for a failed computation.",
      "Property: _tag: Why": "The literal tag separates failure from absence and loading.",
      "Property: _tag: Ownership and lifetime": "Inherits the resource-free lifetime of its enclosing state.",
      "Property: cause": "The complete Effect cause of failure.",
      "Property: cause: Why": "Cause preservation keeps defects and interruption observable alongside typed failures.",
      "Property: cause: Ownership and lifetime": "Inherits the enclosing state's lifetime; Effect Cause is persistent.",
      "Property: progress": "Optional progress for a retry of the failed operation.",
      "Property: progress: Why": "Its presence distinguishes a refreshing failure from a settled failure.",
      "Property: progress: Ownership and lifetime": "Inherits the resource-free lifetime of its enclosing state."
    },
    "examples": [
      {
        "language": "text",
        "code": "```ts\nimport { failure } from \"@typed/async-data\"\nimport { Cause } from \"effect\"\nconst state = failure(Cause.fail(\"offline\"))\n```\nSee [Effect Cause](https://effect.website/docs/data-types/cause/)."
      }
    ],
    "relations": [],
    "source": {
      "file": "packages/async-data/src/index.ts",
      "line": 191
    },
    "since": "1.0.0",
    "category": "State models"
  },
  "exposure": {
    "recordKind": "declaration",
    "id": "@typed/async-data#Failure",
    "packageName": "@typed/async-data",
    "packageVersion": "1.0.0-beta.13",
    "moduleName": ".",
    "consumerSpecifier": "@typed/async-data",
    "exportName": "Failure",
    "qualifiedName": "Failure",
    "declarationKey": "declaration:6882464c90cead669e363df3",
    "family": "interface",
    "signatures": [
      "export interface Failure<E> {\n    readonly _tag: \"Failure\";\n    readonly cause: Cause.Cause<E>;\n    readonly progress?: Progress | undefined;\n}"
    ],
    "sourceSpans": [
      {
        "file": "packages/async-data/src/index.ts",
        "start": {
          "line": 191,
          "column": 1
        },
        "end": {
          "line": 225,
          "column": 2
        }
      },
      {
        "file": "packages/async-data/src/index.ts",
        "start": {
          "line": 202,
          "column": 3
        },
        "end": {
          "line": 202,
          "column": 28
        }
      },
      {
        "file": "packages/async-data/src/index.ts",
        "start": {
          "line": 213,
          "column": 3
        },
        "end": {
          "line": 213,
          "column": 34
        }
      },
      {
        "file": "packages/async-data/src/index.ts",
        "start": {
          "line": 224,
          "column": 3
        },
        "end": {
          "line": 224,
          "column": 44
        }
      }
    ],
    "aliases": [],
    "isAlias": false,
    "static": false
  },
  "declaration": {
    "declarationKey": "declaration:6882464c90cead669e363df3",
    "name": "Failure",
    "family": "interface",
    "facets": [
      {
        "family": "interface",
        "syntaxKind": "InterfaceDeclaration",
        "signatures": [
          "export interface Failure<E> {\n    readonly _tag: \"Failure\";\n    readonly cause: Cause.Cause<E>;\n    readonly progress?: Progress | undefined;\n}"
        ],
        "typeParameters": [
          "E"
        ],
        "sourceSpans": [
          {
            "file": "packages/async-data/src/index.ts",
            "start": {
              "line": 191,
              "column": 1
            },
            "end": {
              "line": 225,
              "column": 2
            }
          }
        ],
        "static": false,
        "readonly": false,
        "optional": false
      },
      {
        "family": "property",
        "syntaxKind": "PropertySignature",
        "signatures": [
          "readonly _tag: \"Failure\";"
        ],
        "typeParameters": [],
        "sourceSpans": [
          {
            "file": "packages/async-data/src/index.ts",
            "start": {
              "line": 202,
              "column": 3
            },
            "end": {
              "line": 202,
              "column": 28
            }
          }
        ],
        "static": false,
        "readonly": true,
        "optional": false
      },
      {
        "family": "property",
        "syntaxKind": "PropertySignature",
        "signatures": [
          "readonly cause: Cause.Cause<E>;"
        ],
        "typeParameters": [],
        "sourceSpans": [
          {
            "file": "packages/async-data/src/index.ts",
            "start": {
              "line": 213,
              "column": 3
            },
            "end": {
              "line": 213,
              "column": 34
            }
          }
        ],
        "static": false,
        "readonly": true,
        "optional": false
      },
      {
        "family": "property",
        "syntaxKind": "PropertySignature",
        "signatures": [
          "readonly progress?: Progress | undefined;"
        ],
        "typeParameters": [],
        "sourceSpans": [
          {
            "file": "packages/async-data/src/index.ts",
            "start": {
              "line": 224,
              "column": 3
            },
            "end": {
              "line": 224,
              "column": 44
            }
          }
        ],
        "static": false,
        "readonly": true,
        "optional": true
      }
    ],
    "signatures": [
      "export interface Failure<E> {\n    readonly _tag: \"Failure\";\n    readonly cause: Cause.Cause<E>;\n    readonly progress?: Progress | undefined;\n}"
    ],
    "typeParameters": [
      "E"
    ],
    "summary": "Represents an Effect failure, optionally while a retry refreshes it.",
    "sections": {
      "Why": "Retaining the complete Effect `Cause` preserves typed errors, defects, and interruption instead of flattening failure detail.",
      "Ownership and lifetime": "This plain wrapper acquires no resources; its `Cause` is persistent, but the wrapper itself is not frozen.",
      "Property: _tag": "The discriminant for a failed computation.",
      "Property: _tag: Why": "The literal tag separates failure from absence and loading.",
      "Property: _tag: Ownership and lifetime": "Inherits the resource-free lifetime of its enclosing state.",
      "Property: cause": "The complete Effect cause of failure.",
      "Property: cause: Why": "Cause preservation keeps defects and interruption observable alongside typed failures.",
      "Property: cause: Ownership and lifetime": "Inherits the enclosing state's lifetime; Effect Cause is persistent.",
      "Property: progress": "Optional progress for a retry of the failed operation.",
      "Property: progress: Why": "Its presence distinguishes a refreshing failure from a settled failure.",
      "Property: progress: Ownership and lifetime": "Inherits the resource-free lifetime of its enclosing state."
    },
    "examples": [
      {
        "language": "text",
        "code": "```ts\nimport { failure } from \"@typed/async-data\"\nimport { Cause } from \"effect\"\nconst state = failure(Cause.fail(\"offline\"))\n```\nSee [Effect Cause](https://effect.website/docs/data-types/cause/)."
      }
    ],
    "sourceSpans": [
      {
        "file": "packages/async-data/src/index.ts",
        "start": {
          "line": 191,
          "column": 1
        },
        "end": {
          "line": 225,
          "column": 2
        }
      },
      {
        "file": "packages/async-data/src/index.ts",
        "start": {
          "line": 202,
          "column": 3
        },
        "end": {
          "line": 202,
          "column": 28
        }
      },
      {
        "file": "packages/async-data/src/index.ts",
        "start": {
          "line": 213,
          "column": 3
        },
        "end": {
          "line": 213,
          "column": 34
        }
      },
      {
        "file": "packages/async-data/src/index.ts",
        "start": {
          "line": 224,
          "column": 3
        },
        "end": {
          "line": 224,
          "column": 44
        }
      }
    ],
    "since": "1.0.0",
    "category": "State models"
  }
}
