@starkeep/storage-s3 0.2.0 → 0.3.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.
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/adapter.ts"],"sourcesContent":["export { S3ObjectStorageAdapter } from \"./adapter.js\";\nexport type { S3ObjectStorageAdapterOptions } from \"./types.js\";\n","import {\n S3Client,\n PutObjectCommand,\n GetObjectCommand,\n DeleteObjectCommand,\n ListObjectsV2Command,\n HeadBucketCommand,\n HeadObjectCommand,\n} from \"@aws-sdk/client-s3\";\nimport { getSignedUrl as awsGetSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport { Upload } from \"@aws-sdk/lib-storage\";\nimport type { ObjectStorageAdapter } from \"@starkeep/storage-adapter\";\nimport type {\n PutOptions,\n GetResult,\n ListOptions,\n ListResult,\n SignedUrlOptions,\n SignedPutUrlOptions,\n} from \"@starkeep/storage-adapter\";\nimport type { S3ObjectStorageAdapterOptions } from \"./types.js\";\n\nconst MULTIPART_THRESHOLD_BYTES = 5 * 1024 * 1024;\n\nexport class S3ObjectStorageAdapter implements ObjectStorageAdapter {\n private readonly options: S3ObjectStorageAdapterOptions;\n private client: S3Client | null = null;\n\n constructor(options: S3ObjectStorageAdapterOptions) {\n this.options = options;\n }\n\n private getClient(): S3Client {\n if (!this.client) {\n this.client = new S3Client({\n region: this.options.region,\n // When credentialProvider is set, pass it directly to the AWS SDK.\n // The SDK calls it before each signed request, so STS credentials\n // (e.g. from a Cognito Identity Pool) are always fresh.\n credentials: this.options.credentialProvider\n ? this.options.credentialProvider\n : this.options.credentials,\n });\n }\n return this.client;\n }\n\n private resolveKey(key: string): string {\n return `${this.options.keyPrefix ?? \"\"}${key}`;\n }\n\n async init(): Promise<void> {\n // No-op: S3 client is created lazily on first use\n }\n\n async close(): Promise<void> {\n if (this.client) {\n this.client.destroy();\n this.client = null;\n }\n }\n\n async healthCheck(): Promise<boolean> {\n try {\n await this.getClient().send(\n new HeadBucketCommand({ Bucket: this.options.bucketName }),\n );\n return true;\n } catch {\n return false;\n }\n }\n\n async put(\n key: string,\n data: Buffer | Uint8Array,\n options?: PutOptions,\n ): Promise<void> {\n const resolvedKey = this.resolveKey(key);\n const contentType = options?.contentType;\n\n if (data.byteLength > MULTIPART_THRESHOLD_BYTES) {\n const upload = new Upload({\n client: this.getClient(),\n params: {\n Bucket: this.options.bucketName,\n Key: resolvedKey,\n Body: data,\n ...(contentType ? { ContentType: contentType } : {}),\n },\n });\n await upload.done();\n } else {\n await this.getClient().send(\n new PutObjectCommand({\n Bucket: this.options.bucketName,\n Key: resolvedKey,\n Body: data,\n ...(contentType ? { ContentType: contentType } : {}),\n }),\n );\n }\n }\n\n async get(key: string): Promise<GetResult | null> {\n try {\n const response = await this.getClient().send(\n new GetObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n }),\n );\n\n if (!response.Body) {\n return null;\n }\n\n const byteArray = await response.Body.transformToByteArray();\n const buffer = Buffer.from(byteArray);\n\n return {\n data: buffer,\n contentType: response.ContentType,\n size: buffer.length,\n };\n } catch (error: unknown) {\n if (isMissingOrForbidden(error)) {\n return null;\n }\n throw error;\n }\n }\n\n async has(key: string): Promise<boolean> {\n try {\n await this.getClient().send(\n new HeadObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n }),\n );\n return true;\n } catch (error: unknown) {\n if (isMissingOrForbidden(error)) {\n // S3 returns 403 (Forbidden) instead of 404 to callers without\n // s3:ListBucket on the prefix — see the per-app permissions boundary\n // in roles-and-permissions.md, which intentionally withholds ListBucket\n // on shared/*. The two cases are indistinguishable from the SDK, so\n // treat both as \"not present\". A genuine permission problem will\n // surface clearly on the subsequent put/get of the same key.\n return false;\n }\n throw error;\n }\n }\n\n async delete(key: string): Promise<void> {\n await this.getClient().send(\n new DeleteObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n }),\n );\n }\n\n async list(prefix: string, options?: ListOptions): Promise<ListResult> {\n const resolvedPrefix = this.resolveKey(prefix);\n const prefixOffset = (this.options.keyPrefix ?? \"\").length;\n\n const response = await this.getClient().send(\n new ListObjectsV2Command({\n Bucket: this.options.bucketName,\n Prefix: resolvedPrefix,\n MaxKeys: options?.limit,\n ContinuationToken: options?.cursor ?? undefined,\n }),\n );\n\n const keys = (response.Contents ?? []).map(\n (object) => (object.Key ?? \"\").slice(prefixOffset),\n );\n\n return {\n keys,\n nextCursor: response.NextContinuationToken ?? null,\n hasMore: response.IsTruncated ?? false,\n };\n }\n\n async getSignedUrl(\n key: string,\n options?: SignedUrlOptions,\n ): Promise<string> {\n const expiresInSeconds = options?.expiresIn ?? 3600;\n const command = new GetObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n });\n\n return awsGetSignedUrl(this.getClient(), command, {\n expiresIn: expiresInSeconds,\n });\n }\n\n async getSignedPutUrl(\n key: string,\n options?: SignedPutUrlOptions,\n ): Promise<string> {\n const expiresInSeconds = options?.expiresIn ?? 3600;\n const command = new PutObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n ...(options?.contentType ? { ContentType: options.contentType } : {}),\n });\n\n return awsGetSignedUrl(this.getClient(), command, {\n expiresIn: expiresInSeconds,\n });\n }\n}\n\nfunction isMissingOrForbidden(error: unknown): boolean {\n if (!(error instanceof Error)) return false;\n const name = error.name;\n if (name === \"NoSuchKey\" || name === \"NotFound\") return true;\n if (name === \"Forbidden\" || name === \"AccessDenied\") return true;\n const status = (error as { $metadata?: { httpStatusCode?: number } }).$metadata?.httpStatusCode;\n return status === 404 || status === 403;\n}\n"],"mappings":"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","names":["awsGetSignedUrl"]}
1
+ {"version":3,"sources":["../src/index.ts","../src/adapter.ts"],"sourcesContent":["export { S3ObjectStorageAdapter } from \"./adapter.js\";\nexport type { S3ObjectStorageAdapterOptions } from \"./types.js\";\n","import {\n S3Client,\n PutObjectCommand,\n GetObjectCommand,\n DeleteObjectCommand,\n ListObjectsV2Command,\n HeadBucketCommand,\n HeadObjectCommand,\n} from \"@aws-sdk/client-s3\";\nimport { getSignedUrl as awsGetSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport { Upload } from \"@aws-sdk/lib-storage\";\nimport type { ObjectStorageAdapter } from \"@starkeep/storage-adapter\";\nimport type {\n PutOptions,\n GetResult,\n ListOptions,\n ListResult,\n SignedUrlOptions,\n SignedPutUrlOptions,\n} from \"@starkeep/storage-adapter\";\nimport type { S3ObjectStorageAdapterOptions } from \"./types.js\";\n\nconst MULTIPART_THRESHOLD_BYTES = 5 * 1024 * 1024;\n\nexport class S3ObjectStorageAdapter implements ObjectStorageAdapter {\n private readonly options: S3ObjectStorageAdapterOptions;\n private client: S3Client | null = null;\n\n constructor(options: S3ObjectStorageAdapterOptions) {\n this.options = options;\n }\n\n private getClient(): S3Client {\n if (!this.client) {\n this.client = new S3Client({\n region: this.options.region,\n // When credentialProvider is set, pass it directly to the AWS SDK.\n // The SDK calls it before each signed request, so STS credentials\n // (e.g. from a Cognito Identity Pool) are always fresh.\n credentials: this.options.credentialProvider\n ? this.options.credentialProvider\n : this.options.credentials,\n });\n }\n return this.client;\n }\n\n private resolveKey(key: string): string {\n return `${this.options.keyPrefix ?? \"\"}${key}`;\n }\n\n async init(): Promise<void> {\n // No-op: S3 client is created lazily on first use\n }\n\n async close(): Promise<void> {\n if (this.client) {\n this.client.destroy();\n this.client = null;\n }\n }\n\n async healthCheck(): Promise<boolean> {\n try {\n await this.getClient().send(\n new HeadBucketCommand({ Bucket: this.options.bucketName }),\n );\n return true;\n } catch {\n return false;\n }\n }\n\n async put(\n key: string,\n data: Buffer | Uint8Array,\n options?: PutOptions,\n ): Promise<void> {\n const resolvedKey = this.resolveKey(key);\n const contentType = options?.contentType;\n\n if (data.byteLength > MULTIPART_THRESHOLD_BYTES) {\n const upload = new Upload({\n client: this.getClient(),\n params: {\n Bucket: this.options.bucketName,\n Key: resolvedKey,\n Body: data,\n ...(contentType ? { ContentType: contentType } : {}),\n },\n });\n await upload.done();\n } else {\n await this.getClient().send(\n new PutObjectCommand({\n Bucket: this.options.bucketName,\n Key: resolvedKey,\n Body: data,\n ...(contentType ? { ContentType: contentType } : {}),\n }),\n );\n }\n }\n\n async get(key: string): Promise<GetResult | null> {\n try {\n const response = await this.getClient().send(\n new GetObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n }),\n );\n\n if (!response.Body) {\n return null;\n }\n\n const byteArray = await response.Body.transformToByteArray();\n const buffer = Buffer.from(byteArray);\n\n return {\n data: buffer,\n contentType: response.ContentType,\n size: buffer.length,\n };\n } catch (error: unknown) {\n if (isMissingOrForbidden(error)) {\n return null;\n }\n throw error;\n }\n }\n\n async has(key: string): Promise<boolean> {\n try {\n await this.getClient().send(\n new HeadObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n }),\n );\n return true;\n } catch (error: unknown) {\n if (isMissingOrForbidden(error)) {\n // S3 returns 403 (Forbidden) instead of 404 to callers without\n // s3:ListBucket on the prefix — see the per-app permissions boundary\n // in data-roles-and-permissions.md, which intentionally withholds ListBucket\n // on shared/*. The two cases are indistinguishable from the SDK, so\n // treat both as \"not present\". A genuine permission problem will\n // surface clearly on the subsequent put/get of the same key.\n return false;\n }\n throw error;\n }\n }\n\n async delete(key: string): Promise<void> {\n await this.getClient().send(\n new DeleteObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n }),\n );\n }\n\n async list(prefix: string, options?: ListOptions): Promise<ListResult> {\n const resolvedPrefix = this.resolveKey(prefix);\n const prefixOffset = (this.options.keyPrefix ?? \"\").length;\n\n const response = await this.getClient().send(\n new ListObjectsV2Command({\n Bucket: this.options.bucketName,\n Prefix: resolvedPrefix,\n MaxKeys: options?.limit,\n ContinuationToken: options?.cursor ?? undefined,\n }),\n );\n\n const keys = (response.Contents ?? []).map(\n (object) => (object.Key ?? \"\").slice(prefixOffset),\n );\n\n return {\n keys,\n nextCursor: response.NextContinuationToken ?? null,\n hasMore: response.IsTruncated ?? false,\n };\n }\n\n async getSignedUrl(\n key: string,\n options?: SignedUrlOptions,\n ): Promise<string> {\n const expiresInSeconds = options?.expiresIn ?? 3600;\n const command = new GetObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n });\n\n return awsGetSignedUrl(this.getClient(), command, {\n expiresIn: expiresInSeconds,\n });\n }\n\n async getSignedPutUrl(\n key: string,\n options?: SignedPutUrlOptions,\n ): Promise<string> {\n const expiresInSeconds = options?.expiresIn ?? 3600;\n const command = new PutObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n ...(options?.contentType ? { ContentType: options.contentType } : {}),\n });\n\n return awsGetSignedUrl(this.getClient(), command, {\n expiresIn: expiresInSeconds,\n });\n }\n}\n\nfunction isMissingOrForbidden(error: unknown): boolean {\n if (!(error instanceof Error)) return false;\n const name = error.name;\n if (name === \"NoSuchKey\" || name === \"NotFound\") return true;\n if (name === \"Forbidden\" || name === \"AccessDenied\") return true;\n const status = (error as { $metadata?: { httpStatusCode?: number } }).$metadata?.httpStatusCode;\n return status === 404 || status === 403;\n}\n"],"mappings":"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","names":["awsGetSignedUrl"]}
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/adapter.ts"],"sourcesContent":["import {\n S3Client,\n PutObjectCommand,\n GetObjectCommand,\n DeleteObjectCommand,\n ListObjectsV2Command,\n HeadBucketCommand,\n HeadObjectCommand,\n} from \"@aws-sdk/client-s3\";\nimport { getSignedUrl as awsGetSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport { Upload } from \"@aws-sdk/lib-storage\";\nimport type { ObjectStorageAdapter } from \"@starkeep/storage-adapter\";\nimport type {\n PutOptions,\n GetResult,\n ListOptions,\n ListResult,\n SignedUrlOptions,\n SignedPutUrlOptions,\n} from \"@starkeep/storage-adapter\";\nimport type { S3ObjectStorageAdapterOptions } from \"./types.js\";\n\nconst MULTIPART_THRESHOLD_BYTES = 5 * 1024 * 1024;\n\nexport class S3ObjectStorageAdapter implements ObjectStorageAdapter {\n private readonly options: S3ObjectStorageAdapterOptions;\n private client: S3Client | null = null;\n\n constructor(options: S3ObjectStorageAdapterOptions) {\n this.options = options;\n }\n\n private getClient(): S3Client {\n if (!this.client) {\n this.client = new S3Client({\n region: this.options.region,\n // When credentialProvider is set, pass it directly to the AWS SDK.\n // The SDK calls it before each signed request, so STS credentials\n // (e.g. from a Cognito Identity Pool) are always fresh.\n credentials: this.options.credentialProvider\n ? this.options.credentialProvider\n : this.options.credentials,\n });\n }\n return this.client;\n }\n\n private resolveKey(key: string): string {\n return `${this.options.keyPrefix ?? \"\"}${key}`;\n }\n\n async init(): Promise<void> {\n // No-op: S3 client is created lazily on first use\n }\n\n async close(): Promise<void> {\n if (this.client) {\n this.client.destroy();\n this.client = null;\n }\n }\n\n async healthCheck(): Promise<boolean> {\n try {\n await this.getClient().send(\n new HeadBucketCommand({ Bucket: this.options.bucketName }),\n );\n return true;\n } catch {\n return false;\n }\n }\n\n async put(\n key: string,\n data: Buffer | Uint8Array,\n options?: PutOptions,\n ): Promise<void> {\n const resolvedKey = this.resolveKey(key);\n const contentType = options?.contentType;\n\n if (data.byteLength > MULTIPART_THRESHOLD_BYTES) {\n const upload = new Upload({\n client: this.getClient(),\n params: {\n Bucket: this.options.bucketName,\n Key: resolvedKey,\n Body: data,\n ...(contentType ? { ContentType: contentType } : {}),\n },\n });\n await upload.done();\n } else {\n await this.getClient().send(\n new PutObjectCommand({\n Bucket: this.options.bucketName,\n Key: resolvedKey,\n Body: data,\n ...(contentType ? { ContentType: contentType } : {}),\n }),\n );\n }\n }\n\n async get(key: string): Promise<GetResult | null> {\n try {\n const response = await this.getClient().send(\n new GetObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n }),\n );\n\n if (!response.Body) {\n return null;\n }\n\n const byteArray = await response.Body.transformToByteArray();\n const buffer = Buffer.from(byteArray);\n\n return {\n data: buffer,\n contentType: response.ContentType,\n size: buffer.length,\n };\n } catch (error: unknown) {\n if (isMissingOrForbidden(error)) {\n return null;\n }\n throw error;\n }\n }\n\n async has(key: string): Promise<boolean> {\n try {\n await this.getClient().send(\n new HeadObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n }),\n );\n return true;\n } catch (error: unknown) {\n if (isMissingOrForbidden(error)) {\n // S3 returns 403 (Forbidden) instead of 404 to callers without\n // s3:ListBucket on the prefix — see the per-app permissions boundary\n // in roles-and-permissions.md, which intentionally withholds ListBucket\n // on shared/*. The two cases are indistinguishable from the SDK, so\n // treat both as \"not present\". A genuine permission problem will\n // surface clearly on the subsequent put/get of the same key.\n return false;\n }\n throw error;\n }\n }\n\n async delete(key: string): Promise<void> {\n await this.getClient().send(\n new DeleteObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n }),\n );\n }\n\n async list(prefix: string, options?: ListOptions): Promise<ListResult> {\n const resolvedPrefix = this.resolveKey(prefix);\n const prefixOffset = (this.options.keyPrefix ?? \"\").length;\n\n const response = await this.getClient().send(\n new ListObjectsV2Command({\n Bucket: this.options.bucketName,\n Prefix: resolvedPrefix,\n MaxKeys: options?.limit,\n ContinuationToken: options?.cursor ?? undefined,\n }),\n );\n\n const keys = (response.Contents ?? []).map(\n (object) => (object.Key ?? \"\").slice(prefixOffset),\n );\n\n return {\n keys,\n nextCursor: response.NextContinuationToken ?? null,\n hasMore: response.IsTruncated ?? false,\n };\n }\n\n async getSignedUrl(\n key: string,\n options?: SignedUrlOptions,\n ): Promise<string> {\n const expiresInSeconds = options?.expiresIn ?? 3600;\n const command = new GetObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n });\n\n return awsGetSignedUrl(this.getClient(), command, {\n expiresIn: expiresInSeconds,\n });\n }\n\n async getSignedPutUrl(\n key: string,\n options?: SignedPutUrlOptions,\n ): Promise<string> {\n const expiresInSeconds = options?.expiresIn ?? 3600;\n const command = new PutObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n ...(options?.contentType ? { ContentType: options.contentType } : {}),\n });\n\n return awsGetSignedUrl(this.getClient(), command, {\n expiresIn: expiresInSeconds,\n });\n }\n}\n\nfunction isMissingOrForbidden(error: unknown): boolean {\n if (!(error instanceof Error)) return false;\n const name = error.name;\n if (name === \"NoSuchKey\" || name === \"NotFound\") return true;\n if (name === \"Forbidden\" || name === \"AccessDenied\") return true;\n const status = (error as { $metadata?: { httpStatusCode?: number } }).$metadata?.httpStatusCode;\n return status === 404 || status === 403;\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/adapter.ts"],"sourcesContent":["import {\n S3Client,\n PutObjectCommand,\n GetObjectCommand,\n DeleteObjectCommand,\n ListObjectsV2Command,\n HeadBucketCommand,\n HeadObjectCommand,\n} from \"@aws-sdk/client-s3\";\nimport { getSignedUrl as awsGetSignedUrl } from \"@aws-sdk/s3-request-presigner\";\nimport { Upload } from \"@aws-sdk/lib-storage\";\nimport type { ObjectStorageAdapter } from \"@starkeep/storage-adapter\";\nimport type {\n PutOptions,\n GetResult,\n ListOptions,\n ListResult,\n SignedUrlOptions,\n SignedPutUrlOptions,\n} from \"@starkeep/storage-adapter\";\nimport type { S3ObjectStorageAdapterOptions } from \"./types.js\";\n\nconst MULTIPART_THRESHOLD_BYTES = 5 * 1024 * 1024;\n\nexport class S3ObjectStorageAdapter implements ObjectStorageAdapter {\n private readonly options: S3ObjectStorageAdapterOptions;\n private client: S3Client | null = null;\n\n constructor(options: S3ObjectStorageAdapterOptions) {\n this.options = options;\n }\n\n private getClient(): S3Client {\n if (!this.client) {\n this.client = new S3Client({\n region: this.options.region,\n // When credentialProvider is set, pass it directly to the AWS SDK.\n // The SDK calls it before each signed request, so STS credentials\n // (e.g. from a Cognito Identity Pool) are always fresh.\n credentials: this.options.credentialProvider\n ? this.options.credentialProvider\n : this.options.credentials,\n });\n }\n return this.client;\n }\n\n private resolveKey(key: string): string {\n return `${this.options.keyPrefix ?? \"\"}${key}`;\n }\n\n async init(): Promise<void> {\n // No-op: S3 client is created lazily on first use\n }\n\n async close(): Promise<void> {\n if (this.client) {\n this.client.destroy();\n this.client = null;\n }\n }\n\n async healthCheck(): Promise<boolean> {\n try {\n await this.getClient().send(\n new HeadBucketCommand({ Bucket: this.options.bucketName }),\n );\n return true;\n } catch {\n return false;\n }\n }\n\n async put(\n key: string,\n data: Buffer | Uint8Array,\n options?: PutOptions,\n ): Promise<void> {\n const resolvedKey = this.resolveKey(key);\n const contentType = options?.contentType;\n\n if (data.byteLength > MULTIPART_THRESHOLD_BYTES) {\n const upload = new Upload({\n client: this.getClient(),\n params: {\n Bucket: this.options.bucketName,\n Key: resolvedKey,\n Body: data,\n ...(contentType ? { ContentType: contentType } : {}),\n },\n });\n await upload.done();\n } else {\n await this.getClient().send(\n new PutObjectCommand({\n Bucket: this.options.bucketName,\n Key: resolvedKey,\n Body: data,\n ...(contentType ? { ContentType: contentType } : {}),\n }),\n );\n }\n }\n\n async get(key: string): Promise<GetResult | null> {\n try {\n const response = await this.getClient().send(\n new GetObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n }),\n );\n\n if (!response.Body) {\n return null;\n }\n\n const byteArray = await response.Body.transformToByteArray();\n const buffer = Buffer.from(byteArray);\n\n return {\n data: buffer,\n contentType: response.ContentType,\n size: buffer.length,\n };\n } catch (error: unknown) {\n if (isMissingOrForbidden(error)) {\n return null;\n }\n throw error;\n }\n }\n\n async has(key: string): Promise<boolean> {\n try {\n await this.getClient().send(\n new HeadObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n }),\n );\n return true;\n } catch (error: unknown) {\n if (isMissingOrForbidden(error)) {\n // S3 returns 403 (Forbidden) instead of 404 to callers without\n // s3:ListBucket on the prefix — see the per-app permissions boundary\n // in data-roles-and-permissions.md, which intentionally withholds ListBucket\n // on shared/*. The two cases are indistinguishable from the SDK, so\n // treat both as \"not present\". A genuine permission problem will\n // surface clearly on the subsequent put/get of the same key.\n return false;\n }\n throw error;\n }\n }\n\n async delete(key: string): Promise<void> {\n await this.getClient().send(\n new DeleteObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n }),\n );\n }\n\n async list(prefix: string, options?: ListOptions): Promise<ListResult> {\n const resolvedPrefix = this.resolveKey(prefix);\n const prefixOffset = (this.options.keyPrefix ?? \"\").length;\n\n const response = await this.getClient().send(\n new ListObjectsV2Command({\n Bucket: this.options.bucketName,\n Prefix: resolvedPrefix,\n MaxKeys: options?.limit,\n ContinuationToken: options?.cursor ?? undefined,\n }),\n );\n\n const keys = (response.Contents ?? []).map(\n (object) => (object.Key ?? \"\").slice(prefixOffset),\n );\n\n return {\n keys,\n nextCursor: response.NextContinuationToken ?? null,\n hasMore: response.IsTruncated ?? false,\n };\n }\n\n async getSignedUrl(\n key: string,\n options?: SignedUrlOptions,\n ): Promise<string> {\n const expiresInSeconds = options?.expiresIn ?? 3600;\n const command = new GetObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n });\n\n return awsGetSignedUrl(this.getClient(), command, {\n expiresIn: expiresInSeconds,\n });\n }\n\n async getSignedPutUrl(\n key: string,\n options?: SignedPutUrlOptions,\n ): Promise<string> {\n const expiresInSeconds = options?.expiresIn ?? 3600;\n const command = new PutObjectCommand({\n Bucket: this.options.bucketName,\n Key: this.resolveKey(key),\n ...(options?.contentType ? { ContentType: options.contentType } : {}),\n });\n\n return awsGetSignedUrl(this.getClient(), command, {\n expiresIn: expiresInSeconds,\n });\n }\n}\n\nfunction isMissingOrForbidden(error: unknown): boolean {\n if (!(error instanceof Error)) return false;\n const name = error.name;\n if (name === \"NoSuchKey\" || name === \"NotFound\") return true;\n if (name === \"Forbidden\" || name === \"AccessDenied\") return true;\n const status = (error as { $metadata?: { httpStatusCode?: number } }).$metadata?.httpStatusCode;\n return status === 404 || status === 403;\n}\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@starkeep/storage-s3",
3
- "version": "0.2.0",
3
+ "version": "0.3.0",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",
@@ -22,21 +22,21 @@
22
22
  },
23
23
  "repository": {
24
24
  "type": "git",
25
- "url": "git+https://github.com/starkeep-dev/starkeep-core.git",
25
+ "url": "git+https://github.com/starkeep-org/starkeep-core.git",
26
26
  "directory": "packages/storage-s3"
27
27
  },
28
- "homepage": "https://github.com/starkeep-dev/starkeep-core/tree/main/packages/storage-s3",
28
+ "homepage": "https://github.com/starkeep-org/starkeep-core/tree/main/packages/storage-s3",
29
29
  "dependencies": {
30
30
  "@aws-sdk/client-s3": "^3.700.0",
31
- "@aws-sdk/s3-request-presigner": "^3.700.0",
32
31
  "@aws-sdk/lib-storage": "^3.700.0",
33
- "@starkeep/storage-adapter": "0.2.0"
32
+ "@aws-sdk/s3-request-presigner": "^3.700.0",
33
+ "@starkeep/storage-adapter": "0.3.0"
34
34
  },
35
35
  "devDependencies": {
36
36
  "@types/node": "^25.4.0",
37
37
  "tsup": "^8.0.0",
38
38
  "typescript": "^5.7.0",
39
- "vitest": "^3.0.0"
39
+ "vitest": "^3.2.7"
40
40
  },
41
41
  "scripts": {
42
42
  "build": "tsup",