اتصال S3 را با تایپ‌های صریح بسازید

(cd examples/typescript && npm install)
npm --prefix examples/typescript run check

examples/typescript/
├── .env               # پس از کپی‌کردن فایل نمونه ساخته می‌شود
├── package.json       # وابستگی‌ها و اسکریپت‌های اجرا
├── tsconfig.json      # تنظیمات TypeScript در حالت strict
└── parspack_s3.ts     # Client و هفت فرمان مدیریت فایل

cp examples/.env.example examples/typescript/.env

PARSPACK_S3_ENDPOINT=https://c123456.parspack.net
PARSPACK_S3_BUCKET=c123456
PARSPACK_S3_REGION=us-east-1
PARSPACK_S3_ACCESS_KEY=YOUR_ACCESS_KEY
PARSPACK_S3_SECRET_KEY=YOUR_SECRET_KEY

const endpoint = required("PARSPACK_S3_ENDPOINT").replace(/\/+$/u, "");

const client: S3Client = new S3Client({
endpoint,
region: required("PARSPACK_S3_REGION"),
credentials: {
  accessKeyId: required("PARSPACK_S3_ACCESS_KEY"),
  secretAccessKey: required("PARSPACK_S3_SECRET_KEY"),
},
forcePathStyle: true,
maxAttempts: 3,
});

const file = await stat(localFile);

const result = await client.send(new PutObjectCommand({
Bucket: bucket,
Key: objectKey,
Body: createReadStream(localFile),
ContentLength: file.size,
ContentType: contentTypeFor(localFile),
}));

console.log(result.ETag);

npm --prefix examples/typescript run start -- upload ./hello.txt tutorial/hello.txt

for await (const page of paginateListObjectsV2(
{ client },
{ Bucket: bucket, Prefix: "tutorial/" },
)) {
for (const object of page.Contents ?? []) {
  console.log(object.Key, object.Size, object.LastModified?.toISOString());
}
}

npm --prefix examples/typescript run start -- list tutorial/

const info = await client.send(
new HeadObjectCommand({ Bucket: bucket, Key: objectKey }),
);

console.log(info.ContentLength, info.ContentType ?? "", info.ETag);

npm --prefix examples/typescript run start -- head tutorial/hello.txt

const result = await client.send(
new GetObjectCommand({ Bucket: bucket, Key: objectKey }),
);

await pipeline(result.Body as Readable, createWriteStream("./downloads/hello.txt"));

npm --prefix examples/typescript run start -- download tutorial/hello.txt ./downloads/hello.txt

const downloadUrl: string = await getSignedUrl(
client,
new GetObjectCommand({ Bucket: bucket, Key: objectKey }),
{ expiresIn: 900 },
);

npm --prefix examples/typescript run start -- presign-get tutorial/hello.txt 900

curl --output invoice.pdf "$SIGNED_DOWNLOAD_URL"

const contentType = "text/plain";

const uploadUrl: string = await getSignedUrl(
client,
new PutObjectCommand({ Bucket: bucket, Key: objectKey, ContentType: contentType }),
{ expiresIn: 900, signableHeaders: new Set(["content-type"]) },
);

npm --prefix examples/typescript run start -- presign-put tutorial/upload.txt text/plain 900

curl --request PUT \
--header 'Content-Type: text/plain' \
--upload-file ./hello.txt \
"$SIGNED_UPLOAD_URL"

await fetch(signed.url, {
method: "PUT",
headers: { "Content-Type": signed.headers["Content-Type"] },
body: file,
});

await client.send(
new DeleteObjectCommand({ Bucket: bucket, Key: objectKey }),
);

npm --prefix examples/typescript run start -- delete tutorial/hello.txt

catch (error: unknown) {
console.error(error instanceof Error ? `${error.name}: ${error.message}` : error);
process.exitCode = 1;
}

(cd examples/typescript && npm install)
npm --prefix examples/typescript run check
cp examples/.env.example examples/typescript/.env

# مقدارهای .env را کامل کنید
printf 'hello ParsPack\n' > hello.txt
npm --prefix examples/typescript run start -- upload ./hello.txt tutorial/hello.txt
npm --prefix examples/typescript run start -- list tutorial/
npm --prefix examples/typescript run start -- head tutorial/hello.txt
npm --prefix examples/typescript run start -- download tutorial/hello.txt ./downloads/hello.txt
npm --prefix examples/typescript run start -- presign-get tutorial/hello.txt 900
npm --prefix examples/typescript run start -- presign-put tutorial/upload.txt text/plain 900
npm --prefix examples/typescript run start -- delete tutorial/hello.txt