Cloudflare/images

@swamp/cloudflare/imagesv2026.10.23.1· AGPL-3.0-or-later· 2d agoBEHAVIORS

01README

Cloudflare images infrastructure models

02Release Notes

Updated: variants
Updated: migrations
Updated: sources

03Behaviors3

@swamp/cloudflare/images/migrationsv2026.10.23.1migrations.ts

Global Arguments

Argument	Type	Required	Description
account_id	string	yes	Cloudflare account ID
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
conflictBehaviour?	enum	no	How to handle objects that already exist at the destination.
excludedContentTypes?	array	no	Content types to skip during migration.
pathPrefix?	string	no	Prefix to prepend to image custom IDs.
rootDirectory?	string	no	Only import objects under this prefix in the source bucket.
sourceId?	string	no	The identifier of the source to migrate from.
apiToken?	string	no	Cloudflare API token; overrides the CLOUDFLARE_API_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
apiKey?	string	no	Cloudflare API key for the legacy key+email auth path; overrides the CLOUDFLARE_API_KEY environment variable. Wire with a vault.get(...) expression. Requires email.
email?	string	no	Cloudflare account email for the legacy key+email auth path; overrides the CLOUDFLARE_EMAIL environment variable. Requires apiKey.

fn create()

Create a Migrations

fn get(id: string)

Get a Migrations

Argument	Type	Required	Description
id	string	yes	The ID of the Migrations

fn lookup(allowMissing?: boolean)

Look up an existing Migrations by matching global argument values and import it into state

Argument	Type	Required	Description
allowMissing?	boolean	no	Succeed and record found: false in lookupResult when nothing matches, instead of failing

fn adopt(id: string)

Import an existing Migrations by ID into state for management

Argument	Type	Required	Description
id	string	yes	The ID of the Migrations to import

fn delete(id: string)

Delete the Migrations

Argument	Type	Required	Description
id	string	yes	The ID of the Migrations

fn sync(identifier?: string)

Sync Migrations state from Cloudflare

Argument	Type	Required	Description
identifier?	string	no	Target a specific Migrations by id (e.g. one discovered by list)

Resources

state(infinite)— Migrations resource state

lookupResult(infinite)— Outcome of the most recent lookup

@swamp/cloudflare/images/sourcesv2026.10.23.1sources.ts

Global Arguments

Argument	Type	Required	Description
account_id	string	yes	Cloudflare account ID
name?	string	no	A human-readable name for the source.
account?	string	no	Account identifier for the bucket (required for R2 vendor).
bucket?	string	no	The name of the storage bucket.
secret?	record	no	Storage credentials for accessing the bucket. Shape depends on vendor.
vendor?	enum	no	The cloud storage vendor of the source bucket.
apiToken?	string	no	Cloudflare API token; overrides the CLOUDFLARE_API_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
apiKey?	string	no	Cloudflare API key for the legacy key+email auth path; overrides the CLOUDFLARE_API_KEY environment variable. Wire with a vault.get(...) expression. Requires email.
email?	string	no	Cloudflare account email for the legacy key+email auth path; overrides the CLOUDFLARE_EMAIL environment variable. Requires apiKey.

fn create()

Create a Sources

fn get(id: string)

Get a Sources

Argument	Type	Required	Description
id	string	yes	The ID of the Sources

fn lookup(allowMissing?: boolean)

Look up an existing Sources by matching global argument values and import it into state

Argument	Type	Required	Description
allowMissing?	boolean	no	Succeed and record found: false in lookupResult when nothing matches, instead of failing

fn adopt(id: string)

Import an existing Sources by ID into state for management

Argument	Type	Required	Description
id	string	yes	The ID of the Sources to import

fn update(identifier?: string)

Update Sources attributes

Argument	Type	Required	Description
identifier?	string	no	Target a specific Sources by id (e.g. one discovered by list)

fn delete(id: string)

Delete the Sources

Argument	Type	Required	Description
id	string	yes	The ID of the Sources

fn sync(identifier?: string)

Sync Sources state from Cloudflare

Argument	Type	Required	Description
identifier?	string	no	Target a specific Sources by id (e.g. one discovered by list)

Resources

state(infinite)— Sources resource state

lookupResult(infinite)— Outcome of the most recent lookup

@swamp/cloudflare/images/variantsv2026.10.23.1variants.ts

Global Arguments

Argument	Type	Required	Description
account_id	string	yes	Cloudflare account ID
name	string	yes	Instance name for this resource (used as the unique identifier in the factory pattern)
neverRequireSignedURLs?	boolean	no	Indicates whether the variant can access an image without a signature, regardless of image access control.
options?	object	no	Allows you to define image resizing sizes for different use cases.
id?	string	no
apiToken?	string	no	Cloudflare API token; overrides the CLOUDFLARE_API_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault.
apiKey?	string	no	Cloudflare API key for the legacy key+email auth path; overrides the CLOUDFLARE_API_KEY environment variable. Wire with a vault.get(...) expression. Requires email.
email?	string	no	Cloudflare account email for the legacy key+email auth path; overrides the CLOUDFLARE_EMAIL environment variable. Requires apiKey.

fn create()

Create a Variants

fn get(id: string)

Get a Variants

Argument	Type	Required	Description
id	string	yes	The ID of the Variants

fn lookup(allowMissing?: boolean)

Look up an existing Variants by matching global argument values and import it into state

Argument	Type	Required	Description
allowMissing?	boolean	no	Succeed and record found: false in lookupResult when nothing matches, instead of failing

fn adopt(id: string)

Import an existing Variants by ID into state for management

Argument	Type	Required	Description
id	string	yes	The ID of the Variants to import

fn update(identifier?: string)

Update Variants attributes

Argument	Type	Required	Description
identifier?	string	no	Target a specific Variants by id (e.g. one discovered by list)

fn delete(id: string)

Delete the Variants

Argument	Type	Required	Description
id	string	yes	The ID of the Variants

fn sync(identifier?: string)

Sync Variants state from Cloudflare

Argument	Type	Required	Description
identifier?	string	no	Target a specific Variants by id (e.g. one discovered by list)

Resources

state(infinite)— Variants resource state

lookupResult(infinite)— Outcome of the most recent lookup

04Previous Versions13

2026.10.20.1AGPL-3.0-or-laterOct 20, 2026

Updated: variants
Updated: migrations
Updated: sources

Modified 3 behaviors

2026.10.16.1AGPL-3.0-or-later(was none)Oct 16, 2026

2026.10.13.1Oct 13, 2026

Updated: variants
Updated: migrations
Updated: sources

2026.09.29.1Sep 28, 2026

Updated: variants
Updated: migrations
Updated: sources

2026.09.25.1Sep 25, 2026

Updated: variants

2026.08.25.2Aug 25, 2026

Added: migrations
Added: sources

Added 2 behaviors

2026.08.25.1Aug 25, 2026

Removed 2 behaviors

2026.07.21.1Jul 21, 2026

Updated: variants
Updated: migrations
Updated: sources

2026.07.18.2Jul 18, 2026

Modified 3 behaviors

2026.07.14.1Jul 14, 2026

Added: migrations
Added: sources

Added 2 behaviors

2026.06.08.2Jun 8, 2026

Updated: variants

2026.05.29.1May 29, 2026

Updated: variants

2026.05.22.1May 22, 2026

Added: variants

05Stats

100 / 100

Downloads

Archive size

16.1 KB

Verified by Swamp

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types (deprecated)1/1earned
Dependencies pass trust audit2/2earned
Docs keep secrets in a vault1/1earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License2/2earned
Verified public repository2/2earned

Repository

https://github.com/swamp-club/swamp-extensions

06Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64 windows · x86_64

07Labels

#cloudflare #images #cloud #infrastructure