@depup/cloudflare__workers-types 5.20260929.1-depup.0 → 5.20260930.1-depup.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
@@ -13,8 +13,8 @@ npm install @depup/cloudflare__workers-types
13
13
 
14
14
  | Field | Value |
15
15
  |-------|-------|
16
- | Original | [@cloudflare/workers-types](https://www.npmjs.com/package/@cloudflare/workers-types) @ 5.20260929.1 |
17
- | Processed | 2026-09-29 |
16
+ | Original | [@cloudflare/workers-types](https://www.npmjs.com/package/@cloudflare/workers-types) @ 5.20260930.1 |
17
+ | Processed | 2026-09-30 |
18
18
  | Smoke test | failed |
19
19
  | Deps updated | 0 |
20
20
 
package/changes.json CHANGED
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "bumped": {},
3
- "timestamp": "2026-09-29T08:13:10.243Z",
3
+ "timestamp": "2026-09-30T08:12:32.784Z",
4
4
  "totalUpdated": 0
5
5
  }
@@ -12814,8 +12814,6 @@ interface ArtifactsCreateRepoResult {
12814
12814
  remote: string;
12815
12815
  /** Plaintext access token (only returned at creation time). */
12816
12816
  token: string;
12817
- /** ISO 8601 token expiry timestamp. */
12818
- tokenExpiresAt: string;
12819
12817
  }
12820
12818
  /** Paginated list of repositories. */
12821
12819
  interface ArtifactsRepoListResult {
@@ -12858,11 +12856,62 @@ interface ArtifactsTokenListResult {
12858
12856
  total: number;
12859
12857
  }
12860
12858
  /**
12861
- * Handle for a single repository. Returned by Artifacts.get().
12859
+ * Classification of a Git tree entry derived from its mode.
12862
12860
  *
12861
+ * `tree` is a directory, `blob` is a regular file, `symlink` is a symbolic link,
12862
+ * `gitlink` is a submodule reference, and `exec` is an executable file.
12863
+ */
12864
+ type ArtifactsTreeEntryType = "tree" | "blob" | "symlink" | "gitlink" | "exec";
12865
+ /** An immediate child of a Git tree returned by {@link ArtifactsRepo.readTree}. */
12866
+ interface ArtifactsTreeEntry {
12867
+ /** Name relative to the tree being read. */
12868
+ name: string;
12869
+ /** Canonical Git mode, such as `100644` for a file or `40000` for a tree. */
12870
+ mode: string;
12871
+ /** Lowercase, 40-character SHA-1 object ID. */
12872
+ hash: string;
12873
+ /** Classification derived from `mode`. */
12874
+ type: ArtifactsTreeEntryType;
12875
+ }
12876
+ /** Decoded metadata returned by {@link ArtifactsRepo.readCommit} and {@link ArtifactsRepo.log}. */
12877
+ interface ArtifactsCommitMetadata {
12878
+ /** Lowercase, 40-character SHA-1 commit ID. */
12879
+ hash: string;
12880
+ /** Lowercase, 40-character SHA-1 ID of the commit's root tree. */
12881
+ treeHash: string;
12882
+ /** Commit message with one trailing newline removed, if present. */
12883
+ message: string;
12884
+ /** Author identity from the commit. */
12885
+ author: {
12886
+ /** Author name. */
12887
+ name: string;
12888
+ /** Author email address. */
12889
+ email: string;
12890
+ };
12891
+ /** Committer identity from the commit. */
12892
+ committer: {
12893
+ /** Committer name. */
12894
+ name: string;
12895
+ /** Committer email address. */
12896
+ email: string;
12897
+ };
12898
+ /** Parent commit IDs in Git order; empty for a root commit. */
12899
+ parents: string[];
12900
+ /** Author timestamp in Unix seconds. */
12901
+ authoredAt: number;
12902
+ /** Committer timestamp in Unix seconds. */
12903
+ committedAt: number;
12904
+ }
12905
+ /**
12906
+ * Repository capability returned by {@link Artifacts.get}.
12907
+ *
12908
+ * Metadata is available through {@link info}, not as properties on the capability.
12863
12909
  * Methods may throw `ArtifactsError` with code `INTERNAL_ERROR` if an unexpected service error occurs.
12910
+ *
12911
+ * The capability is an RPC stub. Dispose of it when finished, for example with
12912
+ * `using repo = await env.ARTIFACTS.get(name);`, to release it before the request ends.
12864
12913
  */
12865
- interface ArtifactsRepo extends ArtifactsRepoInfo {
12914
+ interface ArtifactsRepo extends Disposable {
12866
12915
  /**
12867
12916
  * Create an access token for this repo.
12868
12917
  * @param scope Token scope: "write" (default) or "read".
@@ -12882,6 +12931,66 @@ interface ArtifactsRepo extends ArtifactsRepoInfo {
12882
12931
  * @throws {ArtifactsError} with code `INVALID_INPUT` if tokenOrId is empty.
12883
12932
  */
12884
12933
  revokeToken(tokenOrId: string): Promise<boolean>;
12934
+ /**
12935
+ * Retrieve current repository metadata. Each call performs a fresh lookup.
12936
+ * @returns Current public repository metadata.
12937
+ * @throws {ArtifactsError} `NOT_FOUND` if the repository was deleted, or `INTERNAL_ERROR` on
12938
+ * an unexpected lookup failure.
12939
+ */
12940
+ info(): Promise<ArtifactsRepoInfo>;
12941
+ /**
12942
+ * Read the raw bytes of a Git blob by object ID.
12943
+ * @param hash Lowercase, 40-character SHA-1 object ID.
12944
+ * @returns An untyped {@link Blob}, or `null` if the object is missing or is not a Git blob.
12945
+ * @throws {ArtifactsError} `INVALID_INPUT` for a malformed hash, `MEMORY_LIMIT` if the object
12946
+ * cannot be buffered safely, or `INTERNAL_ERROR` on an unexpected read failure.
12947
+ * @see {@link ArtifactsRepo.readFile} to resolve a file by ref and path.
12948
+ */
12949
+ readBlob(hash: string): Promise<Blob | null>;
12950
+ /**
12951
+ * Read the immediate children of a Git tree by object ID.
12952
+ * @param hash Lowercase, 40-character SHA-1 tree ID.
12953
+ * @returns Tree entries, or `null` if the object is missing.
12954
+ * @throws {ArtifactsError} `INVALID_INPUT` for a malformed hash, or `INTERNAL_ERROR` if the
12955
+ * object is not a valid tree or the read fails unexpectedly.
12956
+ * @see {@link ArtifactsTreeEntry}
12957
+ */
12958
+ readTree(hash: string): Promise<ArtifactsTreeEntry[] | null>;
12959
+ /**
12960
+ * Decode a Git commit by object ID.
12961
+ * @param hash Lowercase, 40-character SHA-1 commit ID.
12962
+ * @returns Commit metadata, or `null` if the object is missing.
12963
+ * @throws {ArtifactsError} `INVALID_INPUT` for a malformed hash, or `INTERNAL_ERROR` if the
12964
+ * object is not a valid commit or the read fails unexpectedly.
12965
+ * @see {@link ArtifactsCommitMetadata}
12966
+ */
12967
+ readCommit(hash: string): Promise<ArtifactsCommitMetadata | null>;
12968
+ /**
12969
+ * Resolve a file from a branch, tag, or commit ID and return its bytes with a browser-safe
12970
+ * content type in {@link Blob.type}.
12971
+ * @param args File lookup options.
12972
+ * @param args.ref Branch, tag, or commit ID to resolve.
12973
+ * @param args.path Non-empty repository-relative path.
12974
+ * @returns A MIME-typed {@link Blob}, or `null` if the ref or path cannot resolve to a file.
12975
+ * @throws {ArtifactsError} `INVALID_INPUT` if either argument is empty, `MEMORY_LIMIT` if the
12976
+ * file cannot be buffered safely, or `INTERNAL_ERROR` on an unexpected read failure.
12977
+ */
12978
+ readFile(args: { ref: string; path: string }): Promise<Blob | null>;
12979
+ /**
12980
+ * List commits along the first-parent chain, newest first.
12981
+ * @param opts History options. All fields are optional.
12982
+ * @param opts.ref Branch, tag, or commit ID; defaults to `HEAD`.
12983
+ * @param opts.limit Maximum results; defaults to `50` and is capped at `1000`.
12984
+ * @param opts.offset Number of matching commits to skip; defaults to `0`.
12985
+ * @returns Commit metadata, or an empty array if the ref cannot be resolved.
12986
+ * @throws {ArtifactsError} `INTERNAL_ERROR` on an unexpected traversal failure.
12987
+ * @see {@link ArtifactsCommitMetadata}
12988
+ */
12989
+ log(opts?: {
12990
+ ref?: string;
12991
+ limit?: number;
12992
+ offset?: number;
12993
+ }): Promise<ArtifactsCommitMetadata[]>;
12885
12994
  // ── Fork ──
12886
12995
  /**
12887
12996
  * Fork this repo to a new repo.
@@ -12909,6 +13018,7 @@ interface ArtifactsRepo extends ArtifactsRepoInfo {
12909
13018
  type ArtifactsErrorCode =
12910
13019
  | "ALREADY_EXISTS"
12911
13020
  | "NOT_FOUND"
13021
+ | "CREATE_IN_PROGRESS"
12912
13022
  | "IMPORT_IN_PROGRESS"
12913
13023
  | "FORK_IN_PROGRESS"
12914
13024
  | "INVALID_INPUT"
@@ -12961,6 +13071,7 @@ interface Artifacts {
12961
13071
  * @param name Repository name.
12962
13072
  * @returns Repo handle.
12963
13073
  * @throws {ArtifactsError} with code `NOT_FOUND` if the repo does not exist.
13074
+ * @throws {ArtifactsError} with code `CREATE_IN_PROGRESS` if the repo is still being created.
12964
13075
  * @throws {ArtifactsError} with code `IMPORT_IN_PROGRESS` if the repo is still importing.
12965
13076
  * @throws {ArtifactsError} with code `FORK_IN_PROGRESS` if the repo is still forking.
12966
13077
  */
@@ -15306,6 +15417,29 @@ declare abstract class D1PreparedStatement {
15306
15417
  // TypeScript's interface merging will ensure our empty interface is effectively
15307
15418
  // ignored when `Disposable` is included in the standard lib.
15308
15419
  interface Disposable {}
15420
+ declare module "cloudflare:durable-objects" {
15421
+ /**
15422
+ * Marks a Durable Object method as safe to run more than once. The runtime may then retry calls
15423
+ * to it after a disconnect that might have happened after the method started. It does not
15424
+ * enable retries or change how many are made.
15425
+ *
15426
+ * Each attempt creates its own return value, so if the method returns an `RpcTarget`, its
15427
+ * `[Symbol.dispose]()` may run once per attempt.
15428
+ *
15429
+ * Only public instance methods can be decorated. When composing decorators, apply `@retryable`
15430
+ * outermost (first in source order) so it marks the method that is finally installed.
15431
+ * Otherwise `@retryable` has no effect, and constructing the object logs a warning.
15432
+ * Requires standard (not `experimentalDecorators`) decorators and a bundler that transforms
15433
+ * them, such as Wrangler.
15434
+ */
15435
+ export function retryable<This, Args extends unknown[], Return>(
15436
+ value: (this: This, ...args: Args) => Return,
15437
+ context: ClassMethodDecoratorContext<
15438
+ This,
15439
+ (this: This, ...args: Args) => Return
15440
+ >,
15441
+ ): (this: This, ...args: Args) => Return;
15442
+ }
15309
15443
  /**
15310
15444
  * The returned data after sending an email
15311
15445
  */
@@ -12828,8 +12828,6 @@ export interface ArtifactsCreateRepoResult {
12828
12828
  remote: string;
12829
12829
  /** Plaintext access token (only returned at creation time). */
12830
12830
  token: string;
12831
- /** ISO 8601 token expiry timestamp. */
12832
- tokenExpiresAt: string;
12833
12831
  }
12834
12832
  /** Paginated list of repositories. */
12835
12833
  export interface ArtifactsRepoListResult {
@@ -12872,11 +12870,63 @@ export interface ArtifactsTokenListResult {
12872
12870
  total: number;
12873
12871
  }
12874
12872
  /**
12875
- * Handle for a single repository. Returned by Artifacts.get().
12873
+ * Classification of a Git tree entry derived from its mode.
12874
+ *
12875
+ * `tree` is a directory, `blob` is a regular file, `symlink` is a symbolic link,
12876
+ * `gitlink` is a submodule reference, and `exec` is an executable file.
12877
+ */
12878
+ export type ArtifactsTreeEntryType =
12879
+ "tree" | "blob" | "symlink" | "gitlink" | "exec";
12880
+ /** An immediate child of a Git tree returned by {@link ArtifactsRepo.readTree}. */
12881
+ export interface ArtifactsTreeEntry {
12882
+ /** Name relative to the tree being read. */
12883
+ name: string;
12884
+ /** Canonical Git mode, such as `100644` for a file or `40000` for a tree. */
12885
+ mode: string;
12886
+ /** Lowercase, 40-character SHA-1 object ID. */
12887
+ hash: string;
12888
+ /** Classification derived from `mode`. */
12889
+ type: ArtifactsTreeEntryType;
12890
+ }
12891
+ /** Decoded metadata returned by {@link ArtifactsRepo.readCommit} and {@link ArtifactsRepo.log}. */
12892
+ export interface ArtifactsCommitMetadata {
12893
+ /** Lowercase, 40-character SHA-1 commit ID. */
12894
+ hash: string;
12895
+ /** Lowercase, 40-character SHA-1 ID of the commit's root tree. */
12896
+ treeHash: string;
12897
+ /** Commit message with one trailing newline removed, if present. */
12898
+ message: string;
12899
+ /** Author identity from the commit. */
12900
+ author: {
12901
+ /** Author name. */
12902
+ name: string;
12903
+ /** Author email address. */
12904
+ email: string;
12905
+ };
12906
+ /** Committer identity from the commit. */
12907
+ committer: {
12908
+ /** Committer name. */
12909
+ name: string;
12910
+ /** Committer email address. */
12911
+ email: string;
12912
+ };
12913
+ /** Parent commit IDs in Git order; empty for a root commit. */
12914
+ parents: string[];
12915
+ /** Author timestamp in Unix seconds. */
12916
+ authoredAt: number;
12917
+ /** Committer timestamp in Unix seconds. */
12918
+ committedAt: number;
12919
+ }
12920
+ /**
12921
+ * Repository capability returned by {@link Artifacts.get}.
12876
12922
  *
12923
+ * Metadata is available through {@link info}, not as properties on the capability.
12877
12924
  * Methods may throw `ArtifactsError` with code `INTERNAL_ERROR` if an unexpected service error occurs.
12925
+ *
12926
+ * The capability is an RPC stub. Dispose of it when finished, for example with
12927
+ * `using repo = await env.ARTIFACTS.get(name);`, to release it before the request ends.
12878
12928
  */
12879
- export interface ArtifactsRepo extends ArtifactsRepoInfo {
12929
+ export interface ArtifactsRepo extends Disposable {
12880
12930
  /**
12881
12931
  * Create an access token for this repo.
12882
12932
  * @param scope Token scope: "write" (default) or "read".
@@ -12896,6 +12946,66 @@ export interface ArtifactsRepo extends ArtifactsRepoInfo {
12896
12946
  * @throws {ArtifactsError} with code `INVALID_INPUT` if tokenOrId is empty.
12897
12947
  */
12898
12948
  revokeToken(tokenOrId: string): Promise<boolean>;
12949
+ /**
12950
+ * Retrieve current repository metadata. Each call performs a fresh lookup.
12951
+ * @returns Current public repository metadata.
12952
+ * @throws {ArtifactsError} `NOT_FOUND` if the repository was deleted, or `INTERNAL_ERROR` on
12953
+ * an unexpected lookup failure.
12954
+ */
12955
+ info(): Promise<ArtifactsRepoInfo>;
12956
+ /**
12957
+ * Read the raw bytes of a Git blob by object ID.
12958
+ * @param hash Lowercase, 40-character SHA-1 object ID.
12959
+ * @returns An untyped {@link Blob}, or `null` if the object is missing or is not a Git blob.
12960
+ * @throws {ArtifactsError} `INVALID_INPUT` for a malformed hash, `MEMORY_LIMIT` if the object
12961
+ * cannot be buffered safely, or `INTERNAL_ERROR` on an unexpected read failure.
12962
+ * @see {@link ArtifactsRepo.readFile} to resolve a file by ref and path.
12963
+ */
12964
+ readBlob(hash: string): Promise<Blob | null>;
12965
+ /**
12966
+ * Read the immediate children of a Git tree by object ID.
12967
+ * @param hash Lowercase, 40-character SHA-1 tree ID.
12968
+ * @returns Tree entries, or `null` if the object is missing.
12969
+ * @throws {ArtifactsError} `INVALID_INPUT` for a malformed hash, or `INTERNAL_ERROR` if the
12970
+ * object is not a valid tree or the read fails unexpectedly.
12971
+ * @see {@link ArtifactsTreeEntry}
12972
+ */
12973
+ readTree(hash: string): Promise<ArtifactsTreeEntry[] | null>;
12974
+ /**
12975
+ * Decode a Git commit by object ID.
12976
+ * @param hash Lowercase, 40-character SHA-1 commit ID.
12977
+ * @returns Commit metadata, or `null` if the object is missing.
12978
+ * @throws {ArtifactsError} `INVALID_INPUT` for a malformed hash, or `INTERNAL_ERROR` if the
12979
+ * object is not a valid commit or the read fails unexpectedly.
12980
+ * @see {@link ArtifactsCommitMetadata}
12981
+ */
12982
+ readCommit(hash: string): Promise<ArtifactsCommitMetadata | null>;
12983
+ /**
12984
+ * Resolve a file from a branch, tag, or commit ID and return its bytes with a browser-safe
12985
+ * content type in {@link Blob.type}.
12986
+ * @param args File lookup options.
12987
+ * @param args.ref Branch, tag, or commit ID to resolve.
12988
+ * @param args.path Non-empty repository-relative path.
12989
+ * @returns A MIME-typed {@link Blob}, or `null` if the ref or path cannot resolve to a file.
12990
+ * @throws {ArtifactsError} `INVALID_INPUT` if either argument is empty, `MEMORY_LIMIT` if the
12991
+ * file cannot be buffered safely, or `INTERNAL_ERROR` on an unexpected read failure.
12992
+ */
12993
+ readFile(args: { ref: string; path: string }): Promise<Blob | null>;
12994
+ /**
12995
+ * List commits along the first-parent chain, newest first.
12996
+ * @param opts History options. All fields are optional.
12997
+ * @param opts.ref Branch, tag, or commit ID; defaults to `HEAD`.
12998
+ * @param opts.limit Maximum results; defaults to `50` and is capped at `1000`.
12999
+ * @param opts.offset Number of matching commits to skip; defaults to `0`.
13000
+ * @returns Commit metadata, or an empty array if the ref cannot be resolved.
13001
+ * @throws {ArtifactsError} `INTERNAL_ERROR` on an unexpected traversal failure.
13002
+ * @see {@link ArtifactsCommitMetadata}
13003
+ */
13004
+ log(opts?: {
13005
+ ref?: string;
13006
+ limit?: number;
13007
+ offset?: number;
13008
+ }): Promise<ArtifactsCommitMetadata[]>;
12899
13009
  // ── Fork ──
12900
13010
  /**
12901
13011
  * Fork this repo to a new repo.
@@ -12923,6 +13033,7 @@ export interface ArtifactsRepo extends ArtifactsRepoInfo {
12923
13033
  export type ArtifactsErrorCode =
12924
13034
  | "ALREADY_EXISTS"
12925
13035
  | "NOT_FOUND"
13036
+ | "CREATE_IN_PROGRESS"
12926
13037
  | "IMPORT_IN_PROGRESS"
12927
13038
  | "FORK_IN_PROGRESS"
12928
13039
  | "INVALID_INPUT"
@@ -12975,6 +13086,7 @@ export interface Artifacts {
12975
13086
  * @param name Repository name.
12976
13087
  * @returns Repo handle.
12977
13088
  * @throws {ArtifactsError} with code `NOT_FOUND` if the repo does not exist.
13089
+ * @throws {ArtifactsError} with code `CREATE_IN_PROGRESS` if the repo is still being created.
12978
13090
  * @throws {ArtifactsError} with code `IMPORT_IN_PROGRESS` if the repo is still importing.
12979
13091
  * @throws {ArtifactsError} with code `FORK_IN_PROGRESS` if the repo is still forking.
12980
13092
  */
package/index.d.ts CHANGED
@@ -12474,8 +12474,6 @@ interface ArtifactsCreateRepoResult {
12474
12474
  remote: string;
12475
12475
  /** Plaintext access token (only returned at creation time). */
12476
12476
  token: string;
12477
- /** ISO 8601 token expiry timestamp. */
12478
- tokenExpiresAt: string;
12479
12477
  }
12480
12478
  /** Paginated list of repositories. */
12481
12479
  interface ArtifactsRepoListResult {
@@ -12518,11 +12516,62 @@ interface ArtifactsTokenListResult {
12518
12516
  total: number;
12519
12517
  }
12520
12518
  /**
12521
- * Handle for a single repository. Returned by Artifacts.get().
12519
+ * Classification of a Git tree entry derived from its mode.
12522
12520
  *
12521
+ * `tree` is a directory, `blob` is a regular file, `symlink` is a symbolic link,
12522
+ * `gitlink` is a submodule reference, and `exec` is an executable file.
12523
+ */
12524
+ type ArtifactsTreeEntryType = "tree" | "blob" | "symlink" | "gitlink" | "exec";
12525
+ /** An immediate child of a Git tree returned by {@link ArtifactsRepo.readTree}. */
12526
+ interface ArtifactsTreeEntry {
12527
+ /** Name relative to the tree being read. */
12528
+ name: string;
12529
+ /** Canonical Git mode, such as `100644` for a file or `40000` for a tree. */
12530
+ mode: string;
12531
+ /** Lowercase, 40-character SHA-1 object ID. */
12532
+ hash: string;
12533
+ /** Classification derived from `mode`. */
12534
+ type: ArtifactsTreeEntryType;
12535
+ }
12536
+ /** Decoded metadata returned by {@link ArtifactsRepo.readCommit} and {@link ArtifactsRepo.log}. */
12537
+ interface ArtifactsCommitMetadata {
12538
+ /** Lowercase, 40-character SHA-1 commit ID. */
12539
+ hash: string;
12540
+ /** Lowercase, 40-character SHA-1 ID of the commit's root tree. */
12541
+ treeHash: string;
12542
+ /** Commit message with one trailing newline removed, if present. */
12543
+ message: string;
12544
+ /** Author identity from the commit. */
12545
+ author: {
12546
+ /** Author name. */
12547
+ name: string;
12548
+ /** Author email address. */
12549
+ email: string;
12550
+ };
12551
+ /** Committer identity from the commit. */
12552
+ committer: {
12553
+ /** Committer name. */
12554
+ name: string;
12555
+ /** Committer email address. */
12556
+ email: string;
12557
+ };
12558
+ /** Parent commit IDs in Git order; empty for a root commit. */
12559
+ parents: string[];
12560
+ /** Author timestamp in Unix seconds. */
12561
+ authoredAt: number;
12562
+ /** Committer timestamp in Unix seconds. */
12563
+ committedAt: number;
12564
+ }
12565
+ /**
12566
+ * Repository capability returned by {@link Artifacts.get}.
12567
+ *
12568
+ * Metadata is available through {@link info}, not as properties on the capability.
12523
12569
  * Methods may throw `ArtifactsError` with code `INTERNAL_ERROR` if an unexpected service error occurs.
12570
+ *
12571
+ * The capability is an RPC stub. Dispose of it when finished, for example with
12572
+ * `using repo = await env.ARTIFACTS.get(name);`, to release it before the request ends.
12524
12573
  */
12525
- interface ArtifactsRepo extends ArtifactsRepoInfo {
12574
+ interface ArtifactsRepo extends Disposable {
12526
12575
  /**
12527
12576
  * Create an access token for this repo.
12528
12577
  * @param scope Token scope: "write" (default) or "read".
@@ -12542,6 +12591,66 @@ interface ArtifactsRepo extends ArtifactsRepoInfo {
12542
12591
  * @throws {ArtifactsError} with code `INVALID_INPUT` if tokenOrId is empty.
12543
12592
  */
12544
12593
  revokeToken(tokenOrId: string): Promise<boolean>;
12594
+ /**
12595
+ * Retrieve current repository metadata. Each call performs a fresh lookup.
12596
+ * @returns Current public repository metadata.
12597
+ * @throws {ArtifactsError} `NOT_FOUND` if the repository was deleted, or `INTERNAL_ERROR` on
12598
+ * an unexpected lookup failure.
12599
+ */
12600
+ info(): Promise<ArtifactsRepoInfo>;
12601
+ /**
12602
+ * Read the raw bytes of a Git blob by object ID.
12603
+ * @param hash Lowercase, 40-character SHA-1 object ID.
12604
+ * @returns An untyped {@link Blob}, or `null` if the object is missing or is not a Git blob.
12605
+ * @throws {ArtifactsError} `INVALID_INPUT` for a malformed hash, `MEMORY_LIMIT` if the object
12606
+ * cannot be buffered safely, or `INTERNAL_ERROR` on an unexpected read failure.
12607
+ * @see {@link ArtifactsRepo.readFile} to resolve a file by ref and path.
12608
+ */
12609
+ readBlob(hash: string): Promise<Blob | null>;
12610
+ /**
12611
+ * Read the immediate children of a Git tree by object ID.
12612
+ * @param hash Lowercase, 40-character SHA-1 tree ID.
12613
+ * @returns Tree entries, or `null` if the object is missing.
12614
+ * @throws {ArtifactsError} `INVALID_INPUT` for a malformed hash, or `INTERNAL_ERROR` if the
12615
+ * object is not a valid tree or the read fails unexpectedly.
12616
+ * @see {@link ArtifactsTreeEntry}
12617
+ */
12618
+ readTree(hash: string): Promise<ArtifactsTreeEntry[] | null>;
12619
+ /**
12620
+ * Decode a Git commit by object ID.
12621
+ * @param hash Lowercase, 40-character SHA-1 commit ID.
12622
+ * @returns Commit metadata, or `null` if the object is missing.
12623
+ * @throws {ArtifactsError} `INVALID_INPUT` for a malformed hash, or `INTERNAL_ERROR` if the
12624
+ * object is not a valid commit or the read fails unexpectedly.
12625
+ * @see {@link ArtifactsCommitMetadata}
12626
+ */
12627
+ readCommit(hash: string): Promise<ArtifactsCommitMetadata | null>;
12628
+ /**
12629
+ * Resolve a file from a branch, tag, or commit ID and return its bytes with a browser-safe
12630
+ * content type in {@link Blob.type}.
12631
+ * @param args File lookup options.
12632
+ * @param args.ref Branch, tag, or commit ID to resolve.
12633
+ * @param args.path Non-empty repository-relative path.
12634
+ * @returns A MIME-typed {@link Blob}, or `null` if the ref or path cannot resolve to a file.
12635
+ * @throws {ArtifactsError} `INVALID_INPUT` if either argument is empty, `MEMORY_LIMIT` if the
12636
+ * file cannot be buffered safely, or `INTERNAL_ERROR` on an unexpected read failure.
12637
+ */
12638
+ readFile(args: { ref: string; path: string }): Promise<Blob | null>;
12639
+ /**
12640
+ * List commits along the first-parent chain, newest first.
12641
+ * @param opts History options. All fields are optional.
12642
+ * @param opts.ref Branch, tag, or commit ID; defaults to `HEAD`.
12643
+ * @param opts.limit Maximum results; defaults to `50` and is capped at `1000`.
12644
+ * @param opts.offset Number of matching commits to skip; defaults to `0`.
12645
+ * @returns Commit metadata, or an empty array if the ref cannot be resolved.
12646
+ * @throws {ArtifactsError} `INTERNAL_ERROR` on an unexpected traversal failure.
12647
+ * @see {@link ArtifactsCommitMetadata}
12648
+ */
12649
+ log(opts?: {
12650
+ ref?: string;
12651
+ limit?: number;
12652
+ offset?: number;
12653
+ }): Promise<ArtifactsCommitMetadata[]>;
12545
12654
  // ── Fork ──
12546
12655
  /**
12547
12656
  * Fork this repo to a new repo.
@@ -12569,6 +12678,7 @@ interface ArtifactsRepo extends ArtifactsRepoInfo {
12569
12678
  type ArtifactsErrorCode =
12570
12679
  | "ALREADY_EXISTS"
12571
12680
  | "NOT_FOUND"
12681
+ | "CREATE_IN_PROGRESS"
12572
12682
  | "IMPORT_IN_PROGRESS"
12573
12683
  | "FORK_IN_PROGRESS"
12574
12684
  | "INVALID_INPUT"
@@ -12621,6 +12731,7 @@ interface Artifacts {
12621
12731
  * @param name Repository name.
12622
12732
  * @returns Repo handle.
12623
12733
  * @throws {ArtifactsError} with code `NOT_FOUND` if the repo does not exist.
12734
+ * @throws {ArtifactsError} with code `CREATE_IN_PROGRESS` if the repo is still being created.
12624
12735
  * @throws {ArtifactsError} with code `IMPORT_IN_PROGRESS` if the repo is still importing.
12625
12736
  * @throws {ArtifactsError} with code `FORK_IN_PROGRESS` if the repo is still forking.
12626
12737
  */
@@ -14966,6 +15077,29 @@ declare abstract class D1PreparedStatement {
14966
15077
  // TypeScript's interface merging will ensure our empty interface is effectively
14967
15078
  // ignored when `Disposable` is included in the standard lib.
14968
15079
  interface Disposable {}
15080
+ declare module "cloudflare:durable-objects" {
15081
+ /**
15082
+ * Marks a Durable Object method as safe to run more than once. The runtime may then retry calls
15083
+ * to it after a disconnect that might have happened after the method started. It does not
15084
+ * enable retries or change how many are made.
15085
+ *
15086
+ * Each attempt creates its own return value, so if the method returns an `RpcTarget`, its
15087
+ * `[Symbol.dispose]()` may run once per attempt.
15088
+ *
15089
+ * Only public instance methods can be decorated. When composing decorators, apply `@retryable`
15090
+ * outermost (first in source order) so it marks the method that is finally installed.
15091
+ * Otherwise `@retryable` has no effect, and constructing the object logs a warning.
15092
+ * Requires standard (not `experimentalDecorators`) decorators and a bundler that transforms
15093
+ * them, such as Wrangler.
15094
+ */
15095
+ export function retryable<This, Args extends unknown[], Return>(
15096
+ value: (this: This, ...args: Args) => Return,
15097
+ context: ClassMethodDecoratorContext<
15098
+ This,
15099
+ (this: This, ...args: Args) => Return
15100
+ >,
15101
+ ): (this: This, ...args: Args) => Return;
15102
+ }
14969
15103
  /**
14970
15104
  * The returned data after sending an email
14971
15105
  */
package/index.ts CHANGED
@@ -12488,8 +12488,6 @@ export interface ArtifactsCreateRepoResult {
12488
12488
  remote: string;
12489
12489
  /** Plaintext access token (only returned at creation time). */
12490
12490
  token: string;
12491
- /** ISO 8601 token expiry timestamp. */
12492
- tokenExpiresAt: string;
12493
12491
  }
12494
12492
  /** Paginated list of repositories. */
12495
12493
  export interface ArtifactsRepoListResult {
@@ -12532,11 +12530,63 @@ export interface ArtifactsTokenListResult {
12532
12530
  total: number;
12533
12531
  }
12534
12532
  /**
12535
- * Handle for a single repository. Returned by Artifacts.get().
12533
+ * Classification of a Git tree entry derived from its mode.
12534
+ *
12535
+ * `tree` is a directory, `blob` is a regular file, `symlink` is a symbolic link,
12536
+ * `gitlink` is a submodule reference, and `exec` is an executable file.
12537
+ */
12538
+ export type ArtifactsTreeEntryType =
12539
+ "tree" | "blob" | "symlink" | "gitlink" | "exec";
12540
+ /** An immediate child of a Git tree returned by {@link ArtifactsRepo.readTree}. */
12541
+ export interface ArtifactsTreeEntry {
12542
+ /** Name relative to the tree being read. */
12543
+ name: string;
12544
+ /** Canonical Git mode, such as `100644` for a file or `40000` for a tree. */
12545
+ mode: string;
12546
+ /** Lowercase, 40-character SHA-1 object ID. */
12547
+ hash: string;
12548
+ /** Classification derived from `mode`. */
12549
+ type: ArtifactsTreeEntryType;
12550
+ }
12551
+ /** Decoded metadata returned by {@link ArtifactsRepo.readCommit} and {@link ArtifactsRepo.log}. */
12552
+ export interface ArtifactsCommitMetadata {
12553
+ /** Lowercase, 40-character SHA-1 commit ID. */
12554
+ hash: string;
12555
+ /** Lowercase, 40-character SHA-1 ID of the commit's root tree. */
12556
+ treeHash: string;
12557
+ /** Commit message with one trailing newline removed, if present. */
12558
+ message: string;
12559
+ /** Author identity from the commit. */
12560
+ author: {
12561
+ /** Author name. */
12562
+ name: string;
12563
+ /** Author email address. */
12564
+ email: string;
12565
+ };
12566
+ /** Committer identity from the commit. */
12567
+ committer: {
12568
+ /** Committer name. */
12569
+ name: string;
12570
+ /** Committer email address. */
12571
+ email: string;
12572
+ };
12573
+ /** Parent commit IDs in Git order; empty for a root commit. */
12574
+ parents: string[];
12575
+ /** Author timestamp in Unix seconds. */
12576
+ authoredAt: number;
12577
+ /** Committer timestamp in Unix seconds. */
12578
+ committedAt: number;
12579
+ }
12580
+ /**
12581
+ * Repository capability returned by {@link Artifacts.get}.
12536
12582
  *
12583
+ * Metadata is available through {@link info}, not as properties on the capability.
12537
12584
  * Methods may throw `ArtifactsError` with code `INTERNAL_ERROR` if an unexpected service error occurs.
12585
+ *
12586
+ * The capability is an RPC stub. Dispose of it when finished, for example with
12587
+ * `using repo = await env.ARTIFACTS.get(name);`, to release it before the request ends.
12538
12588
  */
12539
- export interface ArtifactsRepo extends ArtifactsRepoInfo {
12589
+ export interface ArtifactsRepo extends Disposable {
12540
12590
  /**
12541
12591
  * Create an access token for this repo.
12542
12592
  * @param scope Token scope: "write" (default) or "read".
@@ -12556,6 +12606,66 @@ export interface ArtifactsRepo extends ArtifactsRepoInfo {
12556
12606
  * @throws {ArtifactsError} with code `INVALID_INPUT` if tokenOrId is empty.
12557
12607
  */
12558
12608
  revokeToken(tokenOrId: string): Promise<boolean>;
12609
+ /**
12610
+ * Retrieve current repository metadata. Each call performs a fresh lookup.
12611
+ * @returns Current public repository metadata.
12612
+ * @throws {ArtifactsError} `NOT_FOUND` if the repository was deleted, or `INTERNAL_ERROR` on
12613
+ * an unexpected lookup failure.
12614
+ */
12615
+ info(): Promise<ArtifactsRepoInfo>;
12616
+ /**
12617
+ * Read the raw bytes of a Git blob by object ID.
12618
+ * @param hash Lowercase, 40-character SHA-1 object ID.
12619
+ * @returns An untyped {@link Blob}, or `null` if the object is missing or is not a Git blob.
12620
+ * @throws {ArtifactsError} `INVALID_INPUT` for a malformed hash, `MEMORY_LIMIT` if the object
12621
+ * cannot be buffered safely, or `INTERNAL_ERROR` on an unexpected read failure.
12622
+ * @see {@link ArtifactsRepo.readFile} to resolve a file by ref and path.
12623
+ */
12624
+ readBlob(hash: string): Promise<Blob | null>;
12625
+ /**
12626
+ * Read the immediate children of a Git tree by object ID.
12627
+ * @param hash Lowercase, 40-character SHA-1 tree ID.
12628
+ * @returns Tree entries, or `null` if the object is missing.
12629
+ * @throws {ArtifactsError} `INVALID_INPUT` for a malformed hash, or `INTERNAL_ERROR` if the
12630
+ * object is not a valid tree or the read fails unexpectedly.
12631
+ * @see {@link ArtifactsTreeEntry}
12632
+ */
12633
+ readTree(hash: string): Promise<ArtifactsTreeEntry[] | null>;
12634
+ /**
12635
+ * Decode a Git commit by object ID.
12636
+ * @param hash Lowercase, 40-character SHA-1 commit ID.
12637
+ * @returns Commit metadata, or `null` if the object is missing.
12638
+ * @throws {ArtifactsError} `INVALID_INPUT` for a malformed hash, or `INTERNAL_ERROR` if the
12639
+ * object is not a valid commit or the read fails unexpectedly.
12640
+ * @see {@link ArtifactsCommitMetadata}
12641
+ */
12642
+ readCommit(hash: string): Promise<ArtifactsCommitMetadata | null>;
12643
+ /**
12644
+ * Resolve a file from a branch, tag, or commit ID and return its bytes with a browser-safe
12645
+ * content type in {@link Blob.type}.
12646
+ * @param args File lookup options.
12647
+ * @param args.ref Branch, tag, or commit ID to resolve.
12648
+ * @param args.path Non-empty repository-relative path.
12649
+ * @returns A MIME-typed {@link Blob}, or `null` if the ref or path cannot resolve to a file.
12650
+ * @throws {ArtifactsError} `INVALID_INPUT` if either argument is empty, `MEMORY_LIMIT` if the
12651
+ * file cannot be buffered safely, or `INTERNAL_ERROR` on an unexpected read failure.
12652
+ */
12653
+ readFile(args: { ref: string; path: string }): Promise<Blob | null>;
12654
+ /**
12655
+ * List commits along the first-parent chain, newest first.
12656
+ * @param opts History options. All fields are optional.
12657
+ * @param opts.ref Branch, tag, or commit ID; defaults to `HEAD`.
12658
+ * @param opts.limit Maximum results; defaults to `50` and is capped at `1000`.
12659
+ * @param opts.offset Number of matching commits to skip; defaults to `0`.
12660
+ * @returns Commit metadata, or an empty array if the ref cannot be resolved.
12661
+ * @throws {ArtifactsError} `INTERNAL_ERROR` on an unexpected traversal failure.
12662
+ * @see {@link ArtifactsCommitMetadata}
12663
+ */
12664
+ log(opts?: {
12665
+ ref?: string;
12666
+ limit?: number;
12667
+ offset?: number;
12668
+ }): Promise<ArtifactsCommitMetadata[]>;
12559
12669
  // ── Fork ──
12560
12670
  /**
12561
12671
  * Fork this repo to a new repo.
@@ -12583,6 +12693,7 @@ export interface ArtifactsRepo extends ArtifactsRepoInfo {
12583
12693
  export type ArtifactsErrorCode =
12584
12694
  | "ALREADY_EXISTS"
12585
12695
  | "NOT_FOUND"
12696
+ | "CREATE_IN_PROGRESS"
12586
12697
  | "IMPORT_IN_PROGRESS"
12587
12698
  | "FORK_IN_PROGRESS"
12588
12699
  | "INVALID_INPUT"
@@ -12635,6 +12746,7 @@ export interface Artifacts {
12635
12746
  * @param name Repository name.
12636
12747
  * @returns Repo handle.
12637
12748
  * @throws {ArtifactsError} with code `NOT_FOUND` if the repo does not exist.
12749
+ * @throws {ArtifactsError} with code `CREATE_IN_PROGRESS` if the repo is still being created.
12638
12750
  * @throws {ArtifactsError} with code `IMPORT_IN_PROGRESS` if the repo is still importing.
12639
12751
  * @throws {ArtifactsError} with code `FORK_IN_PROGRESS` if the repo is still forking.
12640
12752
  */
package/package.json CHANGED
@@ -7,7 +7,7 @@
7
7
  },
8
8
  "author": "Cloudflare Workers DevProd Team <workers-devprod@cloudflare.com> (https://workers.cloudflare.com)",
9
9
  "license": "MIT OR Apache-2.0",
10
- "version": "5.20260929.1-depup.0",
10
+ "version": "5.20260930.1-depup.0",
11
11
  "keywords": [
12
12
  "@cloudflare/workers-types",
13
13
  "depup",
@@ -20,8 +20,8 @@
20
20
  "changes": {},
21
21
  "depsUpdated": 0,
22
22
  "originalPackage": "@cloudflare/workers-types",
23
- "originalVersion": "5.20260929.1",
24
- "processedAt": "2026-09-29T08:13:11.090Z",
23
+ "originalVersion": "5.20260930.1",
24
+ "processedAt": "2026-09-30T08:12:33.802Z",
25
25
  "smokeTest": "failed"
26
26
  }
27
27
  }