@ebay-dt/bonfire-core 0.2.1 → 0.3.0-alpha.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -143,6 +143,7 @@ including uncommitted files.
|
|
|
143
143
|
Lifecycle errors contain only stable codes, never filesystem paths, Git output,
|
|
144
144
|
GitHub CLI output, or secrets. Hosts own user-facing copy for codes such as
|
|
145
145
|
`invalid-input`, `already-exists`, `repository-busy`, `working-tree-conflict`,
|
|
146
|
+
`wrong-branch`, `unresolved-operation`,
|
|
146
147
|
`git-failure`, and `filesystem-failure`.
|
|
147
148
|
|
|
148
149
|
Deployment uses the same validated `PrototypeCommandInput` as other
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"git-management.d.ts","sourceRoot":"","sources":["../src/git-management.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,eAAO,MAAM,SAAS,gCAAgD,CAAC;AACvE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAU;IAEzC,cAGC;CACF;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI3D;AAED,eAAO,MAAM,2BAA2B,uEAM7B,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,mBAAmB,CAK9B;AAED,eAAO,MAAM,8BAA8B,qGAOhC,CAAC;AACZ,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElD,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,0BAA0B,CAKrC;AAED,eAAO,MAAM,wBAAwB,kEAI1B,CAAC;AAEZ,eAAO,MAAM,0BAA0B,8LAW5B,CAAC;AACZ,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C,eAAO,MAAM,0BAA0B,2GAM5B,CAAC;AACZ,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C,eAAO,MAAM,wBAAwB,gGAM1B,CAAC;AACZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG;IAC5C,QAAQ,CAAC,wBAAwB,EAAE,OAAO,MAAM,CAAC;CAClD,CAAC;AAEF,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAU;IAEzC,cAGC;CACF;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,GACb,sBAAsB,CAuBxB;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,sBAAsB,CAAC;IAC7B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,OAAO,CAAC;IACd,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,OAAO,GACZ,yBAAyB,CAW3B;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,6EAA6E;IAC7E,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gFAAgF;IAChF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,WAAW,EAAE,0BAA0B,CAAC;IACxC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC9C,YAAY,EAAE,yBAAyB,CAAC;CACzC,CAAC","sourcesContent":["import type { BranchPreparationAttention } from \"./lifecycle.js\";\nimport type { PrototypeRef } from \"./prototype-ref.js\";\n\nexport const GIT_MODES = Object.freeze([\"managed\", \"manual\"] as const);\nexport type GitMode = (typeof GIT_MODES)[number];\n\nexport class GitModeSettingError extends Error {\n readonly code = \"invalid-input\" as const;\n\n constructor() {\n super(\"Invalid
|
|
1
|
+
{"version":3,"file":"git-management.d.ts","sourceRoot":"","sources":["../src/git-management.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BranchPreparationAttention } from \"./lifecycle.js\";\nimport type { PrototypeRef } from \"./prototype-ref.js\";\n\nexport const GIT_MODES = Object.freeze([\"managed\", \"manual\"] as const);\nexport type GitMode = (typeof GIT_MODES)[number];\n\nexport class GitModeSettingError extends Error {\n readonly code = \"invalid-input\" as const;\n\n constructor() {\n super(\"Invalid BF_GIT_MODE; expected managed or manual\");\n this.name = \"GitModeSettingError\";\n }\n}\n\n/** Parse the public managed/manual setting. Undefined preserves managed mode. */\nexport function parseGitModeSetting(value: unknown): GitMode {\n if (value === undefined || value === \"managed\") return \"managed\";\n if (value === \"manual\") return \"manual\";\n throw new GitModeSettingError();\n}\n\nexport const REPOSITORY_READINESS_STATES = Object.freeze([\n \"ready\",\n \"checking\",\n \"attention\",\n \"blocked\",\n \"unavailable\",\n] as const);\nexport type RepositoryReadiness = (typeof REPOSITORY_READINESS_STATES)[number];\n\nexport function isRepositoryReadiness(\n value: unknown,\n): value is RepositoryReadiness {\n return (\n typeof value === \"string\" &&\n (REPOSITORY_READINESS_STATES as readonly string[]).includes(value)\n );\n}\n\nexport const REPOSITORY_UPDATE_CHECK_STATES = Object.freeze([\n \"not-checked\",\n \"checking\",\n \"up-to-date\",\n \"updates-available\",\n \"attention\",\n \"unavailable\",\n] as const);\nexport type RepositoryUpdateCheckState =\n (typeof REPOSITORY_UPDATE_CHECK_STATES)[number];\n\nexport function isRepositoryUpdateCheckState(\n value: unknown,\n): value is RepositoryUpdateCheckState {\n return (\n typeof value === \"string\" &&\n (REPOSITORY_UPDATE_CHECK_STATES as readonly string[]).includes(value)\n );\n}\n\nexport const MANAGED_REPOSITORY_PATHS = Object.freeze([\n \"package.json\",\n \"pnpm-lock.yaml\",\n \"package-lock.json\",\n] as const);\n\nexport const REPOSITORY_ATTENTION_CODES = Object.freeze([\n \"dirty-worktree\",\n \"fetch-failed\",\n \"merge-conflict\",\n \"wrong-branch\",\n \"detached-head\",\n \"unresolved-operation\",\n \"missing-primary\",\n \"push-failed\",\n \"configuration-invalid\",\n \"unknown\",\n] as const);\nexport type RepositoryAttentionCode =\n (typeof REPOSITORY_ATTENTION_CODES)[number];\n\nexport const REPOSITORY_CHANGE_STATUSES = Object.freeze([\n \"uncommitted\",\n \"committed-unpushed\",\n \"updates-available\",\n \"unresolved\",\n \"deployment-attention\",\n] as const);\nexport type RepositoryChangeStatus =\n (typeof REPOSITORY_CHANGE_STATUSES)[number];\n\nexport const REPOSITORY_CHANGE_SCOPES = Object.freeze([\n \"active-prototype\",\n \"owned-prototype\",\n \"other-prototype\",\n \"out-of-scope\",\n \"unknown\",\n] as const);\nexport type RepositoryChangeScope = (typeof REPOSITORY_CHANGE_SCOPES)[number];\n\nexport type RepositoryRelativePath = string & {\n readonly __repositoryRelativePath: unique symbol;\n};\n\nexport class RepositoryRelativePathError extends Error {\n readonly code = \"invalid-input\" as const;\n\n constructor() {\n super(\"Invalid repository-relative path\");\n this.name = \"RepositoryRelativePathError\";\n }\n}\n\n/**\n * Accept only normalized, repository-relative paths suitable for a client\n * summary. Git-specific quoting, absolute paths, and parent traversal are not\n * part of the public contract.\n */\nexport function parseRepositoryRelativePath(\n value: unknown,\n): RepositoryRelativePath {\n if (\n typeof value !== \"string\" ||\n value.length === 0 ||\n value.length > 4096 ||\n value.includes(\"\\0\") ||\n value.includes(\"\\\\\") ||\n value.startsWith(\"/\") ||\n /^[A-Za-z]:/u.test(value)\n ) {\n throw new RepositoryRelativePathError();\n }\n\n const segments = value.split(\"/\");\n if (\n segments.some(\n (segment) => segment.length === 0 || segment === \".\" || segment === \"..\",\n )\n ) {\n throw new RepositoryRelativePathError();\n }\n\n return value as RepositoryRelativePath;\n}\n\nexport type RepositoryChange = {\n path: RepositoryRelativePath;\n status: RepositoryChangeStatus;\n scope: RepositoryChangeScope;\n prototype?: PrototypeRef;\n};\n\nexport type GitManagementCapabilities = {\n mode: GitMode;\n filesystemLifecycle: boolean;\n gitObservation: boolean;\n save: boolean;\n discard: boolean;\n getUpdates: boolean;\n deploy: boolean;\n};\n\nexport function getGitManagementCapabilities(\n mode: GitMode,\n): GitManagementCapabilities {\n const managed = mode === \"managed\";\n return {\n mode,\n filesystemLifecycle: true,\n gitObservation: true,\n save: managed,\n discard: managed,\n getUpdates: managed,\n deploy: managed,\n };\n}\n\nexport type RepositorySummary = {\n mode: GitMode;\n /** The latest non-ready preparation attempt, retained across clean reads. */\n preparationAttention?: BranchPreparationAttention;\n /** A protected installation marker remains, including after a process restart. */\n preparationPending?: boolean;\n /** The running development server must restart to load updated dependencies. */\n restartRequired?: boolean;\n readiness: RepositoryReadiness;\n updateCheck: RepositoryUpdateCheckState;\n changes: readonly RepositoryChange[];\n attention: readonly RepositoryAttentionCode[];\n capabilities: GitManagementCapabilities;\n};\n"]}
|
package/dist/git-management.js
CHANGED
|
@@ -2,7 +2,7 @@ export const GIT_MODES = Object.freeze(["managed", "manual"]);
|
|
|
2
2
|
export class GitModeSettingError extends Error {
|
|
3
3
|
code = "invalid-input";
|
|
4
4
|
constructor() {
|
|
5
|
-
super("Invalid
|
|
5
|
+
super("Invalid BF_GIT_MODE; expected managed or manual");
|
|
6
6
|
this.name = "GitModeSettingError";
|
|
7
7
|
}
|
|
8
8
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"git-management.js","sourceRoot":"","sources":["../src/git-management.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC,CAAC;AAGvE,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAG,eAAwB,CAAC;IAEzC;QACE,KAAK,CAAC,
|
|
1
|
+
{"version":3,"file":"git-management.js","sourceRoot":"","sources":["../src/git-management.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BranchPreparationAttention } from \"./lifecycle.js\";\nimport type { PrototypeRef } from \"./prototype-ref.js\";\n\nexport const GIT_MODES = Object.freeze([\"managed\", \"manual\"] as const);\nexport type GitMode = (typeof GIT_MODES)[number];\n\nexport class GitModeSettingError extends Error {\n readonly code = \"invalid-input\" as const;\n\n constructor() {\n super(\"Invalid BF_GIT_MODE; expected managed or manual\");\n this.name = \"GitModeSettingError\";\n }\n}\n\n/** Parse the public managed/manual setting. Undefined preserves managed mode. */\nexport function parseGitModeSetting(value: unknown): GitMode {\n if (value === undefined || value === \"managed\") return \"managed\";\n if (value === \"manual\") return \"manual\";\n throw new GitModeSettingError();\n}\n\nexport const REPOSITORY_READINESS_STATES = Object.freeze([\n \"ready\",\n \"checking\",\n \"attention\",\n \"blocked\",\n \"unavailable\",\n] as const);\nexport type RepositoryReadiness = (typeof REPOSITORY_READINESS_STATES)[number];\n\nexport function isRepositoryReadiness(\n value: unknown,\n): value is RepositoryReadiness {\n return (\n typeof value === \"string\" &&\n (REPOSITORY_READINESS_STATES as readonly string[]).includes(value)\n );\n}\n\nexport const REPOSITORY_UPDATE_CHECK_STATES = Object.freeze([\n \"not-checked\",\n \"checking\",\n \"up-to-date\",\n \"updates-available\",\n \"attention\",\n \"unavailable\",\n] as const);\nexport type RepositoryUpdateCheckState =\n (typeof REPOSITORY_UPDATE_CHECK_STATES)[number];\n\nexport function isRepositoryUpdateCheckState(\n value: unknown,\n): value is RepositoryUpdateCheckState {\n return (\n typeof value === \"string\" &&\n (REPOSITORY_UPDATE_CHECK_STATES as readonly string[]).includes(value)\n );\n}\n\nexport const MANAGED_REPOSITORY_PATHS = Object.freeze([\n \"package.json\",\n \"pnpm-lock.yaml\",\n \"package-lock.json\",\n] as const);\n\nexport const REPOSITORY_ATTENTION_CODES = Object.freeze([\n \"dirty-worktree\",\n \"fetch-failed\",\n \"merge-conflict\",\n \"wrong-branch\",\n \"detached-head\",\n \"unresolved-operation\",\n \"missing-primary\",\n \"push-failed\",\n \"configuration-invalid\",\n \"unknown\",\n] as const);\nexport type RepositoryAttentionCode =\n (typeof REPOSITORY_ATTENTION_CODES)[number];\n\nexport const REPOSITORY_CHANGE_STATUSES = Object.freeze([\n \"uncommitted\",\n \"committed-unpushed\",\n \"updates-available\",\n \"unresolved\",\n \"deployment-attention\",\n] as const);\nexport type RepositoryChangeStatus =\n (typeof REPOSITORY_CHANGE_STATUSES)[number];\n\nexport const REPOSITORY_CHANGE_SCOPES = Object.freeze([\n \"active-prototype\",\n \"owned-prototype\",\n \"other-prototype\",\n \"out-of-scope\",\n \"unknown\",\n] as const);\nexport type RepositoryChangeScope = (typeof REPOSITORY_CHANGE_SCOPES)[number];\n\nexport type RepositoryRelativePath = string & {\n readonly __repositoryRelativePath: unique symbol;\n};\n\nexport class RepositoryRelativePathError extends Error {\n readonly code = \"invalid-input\" as const;\n\n constructor() {\n super(\"Invalid repository-relative path\");\n this.name = \"RepositoryRelativePathError\";\n }\n}\n\n/**\n * Accept only normalized, repository-relative paths suitable for a client\n * summary. Git-specific quoting, absolute paths, and parent traversal are not\n * part of the public contract.\n */\nexport function parseRepositoryRelativePath(\n value: unknown,\n): RepositoryRelativePath {\n if (\n typeof value !== \"string\" ||\n value.length === 0 ||\n value.length > 4096 ||\n value.includes(\"\\0\") ||\n value.includes(\"\\\\\") ||\n value.startsWith(\"/\") ||\n /^[A-Za-z]:/u.test(value)\n ) {\n throw new RepositoryRelativePathError();\n }\n\n const segments = value.split(\"/\");\n if (\n segments.some(\n (segment) => segment.length === 0 || segment === \".\" || segment === \"..\",\n )\n ) {\n throw new RepositoryRelativePathError();\n }\n\n return value as RepositoryRelativePath;\n}\n\nexport type RepositoryChange = {\n path: RepositoryRelativePath;\n status: RepositoryChangeStatus;\n scope: RepositoryChangeScope;\n prototype?: PrototypeRef;\n};\n\nexport type GitManagementCapabilities = {\n mode: GitMode;\n filesystemLifecycle: boolean;\n gitObservation: boolean;\n save: boolean;\n discard: boolean;\n getUpdates: boolean;\n deploy: boolean;\n};\n\nexport function getGitManagementCapabilities(\n mode: GitMode,\n): GitManagementCapabilities {\n const managed = mode === \"managed\";\n return {\n mode,\n filesystemLifecycle: true,\n gitObservation: true,\n save: managed,\n discard: managed,\n getUpdates: managed,\n deploy: managed,\n };\n}\n\nexport type RepositorySummary = {\n mode: GitMode;\n /** The latest non-ready preparation attempt, retained across clean reads. */\n preparationAttention?: BranchPreparationAttention;\n /** A protected installation marker remains, including after a process restart. */\n preparationPending?: boolean;\n /** The running development server must restart to load updated dependencies. */\n restartRequired?: boolean;\n readiness: RepositoryReadiness;\n updateCheck: RepositoryUpdateCheckState;\n changes: readonly RepositoryChange[];\n attention: readonly RepositoryAttentionCode[];\n capabilities: GitManagementCapabilities;\n};\n"]}
|
package/dist/lifecycle.d.ts
CHANGED
|
@@ -45,7 +45,7 @@ export type LifecycleRecoveryValue = {
|
|
|
45
45
|
};
|
|
46
46
|
/** All unfinished recovery records returned during lifecycle hydration. */
|
|
47
47
|
export type LifecycleRecoveriesValue = readonly LifecycleRecoveryValue[];
|
|
48
|
-
export type LifecycleErrorCode = "unauthenticated" | "forbidden" | "invalid-input" | "not-found" | "already-exists" | "repository-busy" | "working-tree-conflict" | "protected-prototype-path" | "filesystem-failure" | "git-failure" | "deployment-failure" | "deployment-unavailable" | "timeout" | "unexpected-failure";
|
|
48
|
+
export type LifecycleErrorCode = "unauthenticated" | "forbidden" | "invalid-input" | "not-found" | "already-exists" | "repository-busy" | "working-tree-conflict" | "wrong-branch" | "unresolved-operation" | "protected-prototype-path" | "filesystem-failure" | "git-failure" | "deployment-failure" | "deployment-unavailable" | "timeout" | "unexpected-failure";
|
|
49
49
|
export type LifecycleError = {
|
|
50
50
|
code: LifecycleErrorCode;
|
|
51
51
|
};
|
package/dist/lifecycle.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PrototypeRef } from \"./prototype-ref.js\";\n\nexport type AutomaticBranchSwitchMode = \"enabled\" | \"disabled\";\n\nexport class AutomaticBranchSwitchSettingError extends Error {\n readonly code = \"invalid-input\" as const;\n\n constructor() {\n super(\"Invalid automatic branch-switch setting\");\n this.name = \"AutomaticBranchSwitchSettingError\";\n }\n}\n\nexport function parseAutomaticBranchSwitchSetting(\n value: unknown,\n): AutomaticBranchSwitchMode {\n if (value === undefined || value === \"false\") return \"enabled\";\n if (value === \"true\") return \"disabled\";\n throw new AutomaticBranchSwitchSettingError();\n}\n\nexport const DEPLOYMENT_READY_STATES = Object.freeze([\n \"BLOCKED\",\n \"BUILDING\",\n \"CANCELED\",\n \"ERROR\",\n \"INITIALIZING\",\n \"QUEUED\",\n \"READY\",\n] as const);\n\nexport type DeploymentReadyState = (typeof DEPLOYMENT_READY_STATES)[number];\n\nexport function isDeploymentReadyState(\n value: unknown,\n): value is DeploymentReadyState {\n return (\n typeof value === \"string\" &&\n (DEPLOYMENT_READY_STATES as readonly string[]).includes(value)\n );\n}\n\nexport type DeploymentWarningCode =\n | \"metadata-persistence-failed\"\n | \"primary-merge-failed\"\n | \"publication-cleanup-failed\"\n | \"upload-unconfirmed\"\n | \"preview-unconfirmed\";\n\nexport type LifecycleOperationOutcome = {\n local: {\n status: \"completed\" | \"failed\";\n checkpointSha?: string;\n };\n upload: {\n status: \"not-attempted\" | \"confirmed\" | \"unconfirmed\" | \"failed\";\n sourceSha?: string;\n };\n preview: {\n status: \"not-attempted\" | \"accepted\" | \"unconfirmed\" | \"failed\";\n previewUrl?: string;\n deploymentId?: string;\n };\n publication: {\n status: \"not-attempted\" | \"confirmed\" | \"failed\" | \"pending\" | \"superseded\";\n revision?: string;\n recoveryId?: string;\n };\n};\n\nexport type LifecycleRecoveryKind =\n | \"ordinary-publication\"\n | \"deployment-upload\"\n | \"deployment-preview-unconfirmed\"\n | \"deployment-publication\";\n\nexport type LifecycleRecoveryOperation =\n \"create\" | \"duplicate\" | \"delete\" | \"deploy\";\n\nexport type LifecycleRecoveryValue = {\n recoveryId: string;\n operation: LifecycleRecoveryOperation;\n kind: LifecycleRecoveryKind;\n ref: PrototypeRef;\n sourceSha: string;\n previewUrl?: string;\n deploymentId?: string;\n readyState?: DeploymentReadyState;\n acceptedAt?: string;\n outcome: LifecycleOperationOutcome;\n};\n\n/** All unfinished recovery records returned during lifecycle hydration. */\nexport type LifecycleRecoveriesValue = readonly LifecycleRecoveryValue[];\n\nexport type LifecycleErrorCode =\n | \"unauthenticated\"\n | \"forbidden\"\n | \"invalid-input\"\n | \"not-found\"\n | \"already-exists\"\n | \"repository-busy\"\n | \"working-tree-conflict\"\n | \"protected-prototype-path\"\n | \"filesystem-failure\"\n | \"git-failure\"\n | \"deployment-failure\"\n | \"deployment-unavailable\"\n | \"timeout\"\n | \"unexpected-failure\";\n\nexport type LifecycleError = {\n code: LifecycleErrorCode;\n};\n\nexport type LifecycleResult<Value> =\n { ok: true; value: Value } | { ok: false; error: LifecycleError };\n\nexport type LifecycleRemoteStatus = \"pushed\" | \"local-only\" | \"manual\";\n\n/** Explicit result marker for filesystem-only lifecycle mutations. */\nexport type ManualFilesystemMutationValue = {\n remoteStatus: \"manual\";\n};\nexport type BranchPreparationStatus =\n \"ready\" | \"disabled\" | \"deferred\" | \"unsafe\";\n\nexport type BranchPreparationDeferredReason =\n | \"dirty-worktree\"\n | \"fetch-failed\"\n | \"merge-conflict\"\n | \"protected-collision\"\n | \"pending-recovery\";\n\nexport type BranchPreparationUnsafeReason =\n | \"detached-head\"\n | \"branch-changed\"\n | \"unresolved-operation\"\n | \"missing-primary\"\n | \"identity-divergence\"\n | \"failed-abort\"\n | \"merge-failed\"\n | \"push-failed\"\n | \"reconciliation-failed\";\n\nexport type BranchPreparationReason =\n BranchPreparationDeferredReason | BranchPreparationUnsafeReason;\n\nexport type BranchPreparationEffects = {\n changed: boolean;\n pushed: boolean;\n reconciledPaths: readonly string[];\n restartRequired: boolean;\n /** Platform paths changed by the committed-baseline reconciliation. */\n platformPaths?: readonly string[];\n /** Changed package manifests/lockfiles requiring dependency preparation. */\n dependencyPaths?: readonly string[];\n preparationRequired?: boolean;\n};\n\n/** Result of the existing dependency-installation boundary. */\nexport type DependencyPreparationValue = {\n status: \"not-required\" | \"prepared\" | \"failed\" | \"skipped\";\n dependencyPaths: readonly string[];\n /** True when a protected marker was consumed or retained. */\n pending: boolean;\n restartRequired: boolean;\n};\n\ntype BranchPreparationBase = {\n effects: BranchPreparationEffects;\n affectedPaths?: readonly string[];\n};\n\nexport type BranchPreparationValue =\n | (BranchPreparationBase & { status: \"ready\" })\n | (BranchPreparationBase & { status: \"disabled\" })\n | (BranchPreparationBase & {\n status: \"deferred\";\n reason: BranchPreparationDeferredReason;\n })\n | (BranchPreparationBase & {\n status: \"unsafe\";\n reason: BranchPreparationUnsafeReason;\n });\n\nexport type BranchPreparationAttention = Extract<\n BranchPreparationValue,\n { status: \"disabled\" | \"deferred\" | \"unsafe\" }\n>;\n\nexport type RepositorySummaryRefresh =\n | {\n status: \"refreshed\";\n summary: import(\"./git-management.js\").RepositorySummary;\n }\n | { status: \"failed\"; error: LifecycleErrorCode };\n\nexport type RepositoryUpdateValue = {\n preparation: BranchPreparationValue;\n summaryRefresh: RepositorySummaryRefresh;\n dependencyPreparation?: DependencyPreparationValue;\n};\n\nexport type LifecyclePrototypeValue = {\n ref: PrototypeRef;\n url: string;\n remoteStatus: LifecycleRemoteStatus;\n outcome?: LifecycleOperationOutcome;\n};\n\nexport type CreatePrototypeValue = LifecyclePrototypeValue;\nexport type DuplicatePrototypeValue = LifecyclePrototypeValue;\n\nexport type EditPrototypeValue = {\n edited: true;\n ref: PrototypeRef;\n};\n\nexport type DeletePrototypeValue = {\n deleted: true;\n ref: PrototypeRef;\n outcome?: LifecycleOperationOutcome;\n};\n\nexport type SavePrototypeValue = {\n saved: true;\n};\n\nexport type DiscardPrototypeValue = {\n discarded: true;\n};\n\ntype DeploymentValueBase = {\n ref: PrototypeRef;\n sourceSha: string;\n /** Legacy singular warning field; prefer warnings for new consumers. */\n warning: DeploymentWarningCode | undefined;\n /** Independent deployment and repository warnings, when available. */\n warnings?: readonly DeploymentWarningCode[];\n};\n\nexport type DeploymentValue =\n | (DeploymentValueBase & {\n deployed: true;\n previewUrl: string;\n deploymentId: string;\n readyState: DeploymentReadyState;\n outcome?: LifecycleOperationOutcome;\n })\n | (DeploymentValueBase & {\n deployed: false;\n previewUrl?: never;\n deploymentId?: never;\n readyState?: never;\n outcome: LifecycleOperationOutcome;\n });\n\nexport type DirtyObservationStatus = \"clean\" | \"dirty\";\n\nexport type DirtyObservationValue = {\n status: DirtyObservationStatus;\n /** Existing deployment preview, when one has been persisted. */\n previewUrl?: string | null;\n};\n\nexport function lifecycleSuccess<Value>(value: Value): LifecycleResult<Value> {\n return { ok: true, value };\n}\n\nexport function lifecycleFailure(\n code: LifecycleErrorCode,\n): LifecycleResult<never> {\n return { ok: false, error: { code } };\n}\n\nexport function isLifecycleSuccess<Value>(\n result: LifecycleResult<Value>,\n): result is { ok: true; value: Value } {\n return result.ok;\n}\n\nexport function isLifecycleFailure<Value>(\n result: LifecycleResult<Value>,\n): result is { ok: false; error: LifecycleError } {\n return !result.ok;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PrototypeRef } from \"./prototype-ref.js\";\n\nexport type AutomaticBranchSwitchMode = \"enabled\" | \"disabled\";\n\nexport class AutomaticBranchSwitchSettingError extends Error {\n readonly code = \"invalid-input\" as const;\n\n constructor() {\n super(\"Invalid automatic branch-switch setting\");\n this.name = \"AutomaticBranchSwitchSettingError\";\n }\n}\n\nexport function parseAutomaticBranchSwitchSetting(\n value: unknown,\n): AutomaticBranchSwitchMode {\n if (value === undefined || value === \"false\") return \"enabled\";\n if (value === \"true\") return \"disabled\";\n throw new AutomaticBranchSwitchSettingError();\n}\n\nexport const DEPLOYMENT_READY_STATES = Object.freeze([\n \"BLOCKED\",\n \"BUILDING\",\n \"CANCELED\",\n \"ERROR\",\n \"INITIALIZING\",\n \"QUEUED\",\n \"READY\",\n] as const);\n\nexport type DeploymentReadyState = (typeof DEPLOYMENT_READY_STATES)[number];\n\nexport function isDeploymentReadyState(\n value: unknown,\n): value is DeploymentReadyState {\n return (\n typeof value === \"string\" &&\n (DEPLOYMENT_READY_STATES as readonly string[]).includes(value)\n );\n}\n\nexport type DeploymentWarningCode =\n | \"metadata-persistence-failed\"\n | \"primary-merge-failed\"\n | \"publication-cleanup-failed\"\n | \"upload-unconfirmed\"\n | \"preview-unconfirmed\";\n\nexport type LifecycleOperationOutcome = {\n local: {\n status: \"completed\" | \"failed\";\n checkpointSha?: string;\n };\n upload: {\n status: \"not-attempted\" | \"confirmed\" | \"unconfirmed\" | \"failed\";\n sourceSha?: string;\n };\n preview: {\n status: \"not-attempted\" | \"accepted\" | \"unconfirmed\" | \"failed\";\n previewUrl?: string;\n deploymentId?: string;\n };\n publication: {\n status: \"not-attempted\" | \"confirmed\" | \"failed\" | \"pending\" | \"superseded\";\n revision?: string;\n recoveryId?: string;\n };\n};\n\nexport type LifecycleRecoveryKind =\n | \"ordinary-publication\"\n | \"deployment-upload\"\n | \"deployment-preview-unconfirmed\"\n | \"deployment-publication\";\n\nexport type LifecycleRecoveryOperation =\n \"create\" | \"duplicate\" | \"delete\" | \"deploy\";\n\nexport type LifecycleRecoveryValue = {\n recoveryId: string;\n operation: LifecycleRecoveryOperation;\n kind: LifecycleRecoveryKind;\n ref: PrototypeRef;\n sourceSha: string;\n previewUrl?: string;\n deploymentId?: string;\n readyState?: DeploymentReadyState;\n acceptedAt?: string;\n outcome: LifecycleOperationOutcome;\n};\n\n/** All unfinished recovery records returned during lifecycle hydration. */\nexport type LifecycleRecoveriesValue = readonly LifecycleRecoveryValue[];\n\nexport type LifecycleErrorCode =\n | \"unauthenticated\"\n | \"forbidden\"\n | \"invalid-input\"\n | \"not-found\"\n | \"already-exists\"\n | \"repository-busy\"\n | \"working-tree-conflict\"\n | \"wrong-branch\"\n | \"unresolved-operation\"\n | \"protected-prototype-path\"\n | \"filesystem-failure\"\n | \"git-failure\"\n | \"deployment-failure\"\n | \"deployment-unavailable\"\n | \"timeout\"\n | \"unexpected-failure\";\n\nexport type LifecycleError = {\n code: LifecycleErrorCode;\n};\n\nexport type LifecycleResult<Value> =\n { ok: true; value: Value } | { ok: false; error: LifecycleError };\n\nexport type LifecycleRemoteStatus = \"pushed\" | \"local-only\" | \"manual\";\n\n/** Explicit result marker for filesystem-only lifecycle mutations. */\nexport type ManualFilesystemMutationValue = {\n remoteStatus: \"manual\";\n};\nexport type BranchPreparationStatus =\n \"ready\" | \"disabled\" | \"deferred\" | \"unsafe\";\n\nexport type BranchPreparationDeferredReason =\n | \"dirty-worktree\"\n | \"fetch-failed\"\n | \"merge-conflict\"\n | \"protected-collision\"\n | \"pending-recovery\";\n\nexport type BranchPreparationUnsafeReason =\n | \"detached-head\"\n | \"branch-changed\"\n | \"unresolved-operation\"\n | \"missing-primary\"\n | \"identity-divergence\"\n | \"failed-abort\"\n | \"merge-failed\"\n | \"push-failed\"\n | \"reconciliation-failed\";\n\nexport type BranchPreparationReason =\n BranchPreparationDeferredReason | BranchPreparationUnsafeReason;\n\nexport type BranchPreparationEffects = {\n changed: boolean;\n pushed: boolean;\n reconciledPaths: readonly string[];\n restartRequired: boolean;\n /** Platform paths changed by the committed-baseline reconciliation. */\n platformPaths?: readonly string[];\n /** Changed package manifests/lockfiles requiring dependency preparation. */\n dependencyPaths?: readonly string[];\n preparationRequired?: boolean;\n};\n\n/** Result of the existing dependency-installation boundary. */\nexport type DependencyPreparationValue = {\n status: \"not-required\" | \"prepared\" | \"failed\" | \"skipped\";\n dependencyPaths: readonly string[];\n /** True when a protected marker was consumed or retained. */\n pending: boolean;\n restartRequired: boolean;\n};\n\ntype BranchPreparationBase = {\n effects: BranchPreparationEffects;\n affectedPaths?: readonly string[];\n};\n\nexport type BranchPreparationValue =\n | (BranchPreparationBase & { status: \"ready\" })\n | (BranchPreparationBase & { status: \"disabled\" })\n | (BranchPreparationBase & {\n status: \"deferred\";\n reason: BranchPreparationDeferredReason;\n })\n | (BranchPreparationBase & {\n status: \"unsafe\";\n reason: BranchPreparationUnsafeReason;\n });\n\nexport type BranchPreparationAttention = Extract<\n BranchPreparationValue,\n { status: \"disabled\" | \"deferred\" | \"unsafe\" }\n>;\n\nexport type RepositorySummaryRefresh =\n | {\n status: \"refreshed\";\n summary: import(\"./git-management.js\").RepositorySummary;\n }\n | { status: \"failed\"; error: LifecycleErrorCode };\n\nexport type RepositoryUpdateValue = {\n preparation: BranchPreparationValue;\n summaryRefresh: RepositorySummaryRefresh;\n dependencyPreparation?: DependencyPreparationValue;\n};\n\nexport type LifecyclePrototypeValue = {\n ref: PrototypeRef;\n url: string;\n remoteStatus: LifecycleRemoteStatus;\n outcome?: LifecycleOperationOutcome;\n};\n\nexport type CreatePrototypeValue = LifecyclePrototypeValue;\nexport type DuplicatePrototypeValue = LifecyclePrototypeValue;\n\nexport type EditPrototypeValue = {\n edited: true;\n ref: PrototypeRef;\n};\n\nexport type DeletePrototypeValue = {\n deleted: true;\n ref: PrototypeRef;\n outcome?: LifecycleOperationOutcome;\n};\n\nexport type SavePrototypeValue = {\n saved: true;\n};\n\nexport type DiscardPrototypeValue = {\n discarded: true;\n};\n\ntype DeploymentValueBase = {\n ref: PrototypeRef;\n sourceSha: string;\n /** Legacy singular warning field; prefer warnings for new consumers. */\n warning: DeploymentWarningCode | undefined;\n /** Independent deployment and repository warnings, when available. */\n warnings?: readonly DeploymentWarningCode[];\n};\n\nexport type DeploymentValue =\n | (DeploymentValueBase & {\n deployed: true;\n previewUrl: string;\n deploymentId: string;\n readyState: DeploymentReadyState;\n outcome?: LifecycleOperationOutcome;\n })\n | (DeploymentValueBase & {\n deployed: false;\n previewUrl?: never;\n deploymentId?: never;\n readyState?: never;\n outcome: LifecycleOperationOutcome;\n });\n\nexport type DirtyObservationStatus = \"clean\" | \"dirty\";\n\nexport type DirtyObservationValue = {\n status: DirtyObservationStatus;\n /** Existing deployment preview, when one has been persisted. */\n previewUrl?: string | null;\n};\n\nexport function lifecycleSuccess<Value>(value: Value): LifecycleResult<Value> {\n return { ok: true, value };\n}\n\nexport function lifecycleFailure(\n code: LifecycleErrorCode,\n): LifecycleResult<never> {\n return { ok: false, error: { code } };\n}\n\nexport function isLifecycleSuccess<Value>(\n result: LifecycleResult<Value>,\n): result is { ok: true; value: Value } {\n return result.ok;\n}\n\nexport function isLifecycleFailure<Value>(\n result: LifecycleResult<Value>,\n): result is { ok: false; error: LifecycleError } {\n return !result.ok;\n}\n"]}
|
package/dist/lifecycle.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,iCAAkC,SAAQ,KAAK;IACjD,IAAI,GAAG,eAAwB,CAAC;IAEzC;QACE,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,mCAAmC,CAAC;IAClD,CAAC;CACF;AAED,MAAM,UAAU,iCAAiC,CAC/C,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/D,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC;IACxC,MAAM,IAAI,iCAAiC,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,SAAS;IACT,UAAU;IACV,UAAU;IACV,OAAO;IACP,cAAc;IACd,QAAQ;IACR,OAAO;CACC,CAAC,CAAC;AAIZ,MAAM,UAAU,sBAAsB,CACpC,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,uBAA6C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC/D,CAAC;AACJ,CAAC;
|
|
1
|
+
{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,iCAAkC,SAAQ,KAAK;IACjD,IAAI,GAAG,eAAwB,CAAC;IAEzC;QACE,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,mCAAmC,CAAC;IAClD,CAAC;CACF;AAED,MAAM,UAAU,iCAAiC,CAC/C,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/D,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC;IACxC,MAAM,IAAI,iCAAiC,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IACnD,SAAS;IACT,UAAU;IACV,UAAU;IACV,OAAO;IACP,cAAc;IACd,QAAQ;IACR,OAAO;CACC,CAAC,CAAC;AAIZ,MAAM,UAAU,sBAAsB,CACpC,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,uBAA6C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC/D,CAAC;AACJ,CAAC;AAoOD,MAAM,UAAU,gBAAgB,CAAQ,KAAY;IAClD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,IAAwB;IAExB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAA8B;IAE9B,OAAO,MAAM,CAAC,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAA8B;IAE9B,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;AACpB,CAAC","sourcesContent":["import type { PrototypeRef } from \"./prototype-ref.js\";\n\nexport type AutomaticBranchSwitchMode = \"enabled\" | \"disabled\";\n\nexport class AutomaticBranchSwitchSettingError extends Error {\n readonly code = \"invalid-input\" as const;\n\n constructor() {\n super(\"Invalid automatic branch-switch setting\");\n this.name = \"AutomaticBranchSwitchSettingError\";\n }\n}\n\nexport function parseAutomaticBranchSwitchSetting(\n value: unknown,\n): AutomaticBranchSwitchMode {\n if (value === undefined || value === \"false\") return \"enabled\";\n if (value === \"true\") return \"disabled\";\n throw new AutomaticBranchSwitchSettingError();\n}\n\nexport const DEPLOYMENT_READY_STATES = Object.freeze([\n \"BLOCKED\",\n \"BUILDING\",\n \"CANCELED\",\n \"ERROR\",\n \"INITIALIZING\",\n \"QUEUED\",\n \"READY\",\n] as const);\n\nexport type DeploymentReadyState = (typeof DEPLOYMENT_READY_STATES)[number];\n\nexport function isDeploymentReadyState(\n value: unknown,\n): value is DeploymentReadyState {\n return (\n typeof value === \"string\" &&\n (DEPLOYMENT_READY_STATES as readonly string[]).includes(value)\n );\n}\n\nexport type DeploymentWarningCode =\n | \"metadata-persistence-failed\"\n | \"primary-merge-failed\"\n | \"publication-cleanup-failed\"\n | \"upload-unconfirmed\"\n | \"preview-unconfirmed\";\n\nexport type LifecycleOperationOutcome = {\n local: {\n status: \"completed\" | \"failed\";\n checkpointSha?: string;\n };\n upload: {\n status: \"not-attempted\" | \"confirmed\" | \"unconfirmed\" | \"failed\";\n sourceSha?: string;\n };\n preview: {\n status: \"not-attempted\" | \"accepted\" | \"unconfirmed\" | \"failed\";\n previewUrl?: string;\n deploymentId?: string;\n };\n publication: {\n status: \"not-attempted\" | \"confirmed\" | \"failed\" | \"pending\" | \"superseded\";\n revision?: string;\n recoveryId?: string;\n };\n};\n\nexport type LifecycleRecoveryKind =\n | \"ordinary-publication\"\n | \"deployment-upload\"\n | \"deployment-preview-unconfirmed\"\n | \"deployment-publication\";\n\nexport type LifecycleRecoveryOperation =\n \"create\" | \"duplicate\" | \"delete\" | \"deploy\";\n\nexport type LifecycleRecoveryValue = {\n recoveryId: string;\n operation: LifecycleRecoveryOperation;\n kind: LifecycleRecoveryKind;\n ref: PrototypeRef;\n sourceSha: string;\n previewUrl?: string;\n deploymentId?: string;\n readyState?: DeploymentReadyState;\n acceptedAt?: string;\n outcome: LifecycleOperationOutcome;\n};\n\n/** All unfinished recovery records returned during lifecycle hydration. */\nexport type LifecycleRecoveriesValue = readonly LifecycleRecoveryValue[];\n\nexport type LifecycleErrorCode =\n | \"unauthenticated\"\n | \"forbidden\"\n | \"invalid-input\"\n | \"not-found\"\n | \"already-exists\"\n | \"repository-busy\"\n | \"working-tree-conflict\"\n | \"wrong-branch\"\n | \"unresolved-operation\"\n | \"protected-prototype-path\"\n | \"filesystem-failure\"\n | \"git-failure\"\n | \"deployment-failure\"\n | \"deployment-unavailable\"\n | \"timeout\"\n | \"unexpected-failure\";\n\nexport type LifecycleError = {\n code: LifecycleErrorCode;\n};\n\nexport type LifecycleResult<Value> =\n { ok: true; value: Value } | { ok: false; error: LifecycleError };\n\nexport type LifecycleRemoteStatus = \"pushed\" | \"local-only\" | \"manual\";\n\n/** Explicit result marker for filesystem-only lifecycle mutations. */\nexport type ManualFilesystemMutationValue = {\n remoteStatus: \"manual\";\n};\nexport type BranchPreparationStatus =\n \"ready\" | \"disabled\" | \"deferred\" | \"unsafe\";\n\nexport type BranchPreparationDeferredReason =\n | \"dirty-worktree\"\n | \"fetch-failed\"\n | \"merge-conflict\"\n | \"protected-collision\"\n | \"pending-recovery\";\n\nexport type BranchPreparationUnsafeReason =\n | \"detached-head\"\n | \"branch-changed\"\n | \"unresolved-operation\"\n | \"missing-primary\"\n | \"identity-divergence\"\n | \"failed-abort\"\n | \"merge-failed\"\n | \"push-failed\"\n | \"reconciliation-failed\";\n\nexport type BranchPreparationReason =\n BranchPreparationDeferredReason | BranchPreparationUnsafeReason;\n\nexport type BranchPreparationEffects = {\n changed: boolean;\n pushed: boolean;\n reconciledPaths: readonly string[];\n restartRequired: boolean;\n /** Platform paths changed by the committed-baseline reconciliation. */\n platformPaths?: readonly string[];\n /** Changed package manifests/lockfiles requiring dependency preparation. */\n dependencyPaths?: readonly string[];\n preparationRequired?: boolean;\n};\n\n/** Result of the existing dependency-installation boundary. */\nexport type DependencyPreparationValue = {\n status: \"not-required\" | \"prepared\" | \"failed\" | \"skipped\";\n dependencyPaths: readonly string[];\n /** True when a protected marker was consumed or retained. */\n pending: boolean;\n restartRequired: boolean;\n};\n\ntype BranchPreparationBase = {\n effects: BranchPreparationEffects;\n affectedPaths?: readonly string[];\n};\n\nexport type BranchPreparationValue =\n | (BranchPreparationBase & { status: \"ready\" })\n | (BranchPreparationBase & { status: \"disabled\" })\n | (BranchPreparationBase & {\n status: \"deferred\";\n reason: BranchPreparationDeferredReason;\n })\n | (BranchPreparationBase & {\n status: \"unsafe\";\n reason: BranchPreparationUnsafeReason;\n });\n\nexport type BranchPreparationAttention = Extract<\n BranchPreparationValue,\n { status: \"disabled\" | \"deferred\" | \"unsafe\" }\n>;\n\nexport type RepositorySummaryRefresh =\n | {\n status: \"refreshed\";\n summary: import(\"./git-management.js\").RepositorySummary;\n }\n | { status: \"failed\"; error: LifecycleErrorCode };\n\nexport type RepositoryUpdateValue = {\n preparation: BranchPreparationValue;\n summaryRefresh: RepositorySummaryRefresh;\n dependencyPreparation?: DependencyPreparationValue;\n};\n\nexport type LifecyclePrototypeValue = {\n ref: PrototypeRef;\n url: string;\n remoteStatus: LifecycleRemoteStatus;\n outcome?: LifecycleOperationOutcome;\n};\n\nexport type CreatePrototypeValue = LifecyclePrototypeValue;\nexport type DuplicatePrototypeValue = LifecyclePrototypeValue;\n\nexport type EditPrototypeValue = {\n edited: true;\n ref: PrototypeRef;\n};\n\nexport type DeletePrototypeValue = {\n deleted: true;\n ref: PrototypeRef;\n outcome?: LifecycleOperationOutcome;\n};\n\nexport type SavePrototypeValue = {\n saved: true;\n};\n\nexport type DiscardPrototypeValue = {\n discarded: true;\n};\n\ntype DeploymentValueBase = {\n ref: PrototypeRef;\n sourceSha: string;\n /** Legacy singular warning field; prefer warnings for new consumers. */\n warning: DeploymentWarningCode | undefined;\n /** Independent deployment and repository warnings, when available. */\n warnings?: readonly DeploymentWarningCode[];\n};\n\nexport type DeploymentValue =\n | (DeploymentValueBase & {\n deployed: true;\n previewUrl: string;\n deploymentId: string;\n readyState: DeploymentReadyState;\n outcome?: LifecycleOperationOutcome;\n })\n | (DeploymentValueBase & {\n deployed: false;\n previewUrl?: never;\n deploymentId?: never;\n readyState?: never;\n outcome: LifecycleOperationOutcome;\n });\n\nexport type DirtyObservationStatus = \"clean\" | \"dirty\";\n\nexport type DirtyObservationValue = {\n status: DirtyObservationStatus;\n /** Existing deployment preview, when one has been persisted. */\n previewUrl?: string | null;\n};\n\nexport function lifecycleSuccess<Value>(value: Value): LifecycleResult<Value> {\n return { ok: true, value };\n}\n\nexport function lifecycleFailure(\n code: LifecycleErrorCode,\n): LifecycleResult<never> {\n return { ok: false, error: { code } };\n}\n\nexport function isLifecycleSuccess<Value>(\n result: LifecycleResult<Value>,\n): result is { ok: true; value: Value } {\n return result.ok;\n}\n\nexport function isLifecycleFailure<Value>(\n result: LifecycleResult<Value>,\n): result is { ok: false; error: LifecycleError } {\n return !result.ok;\n}\n"]}
|