@procedures/s3 0.0.0-stage → 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Type definitions for client-s3 procedures
+ *
+ * AWS S3 operations: upload, download, list, delete, multipart upload
+ * Credentials are loaded from environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY)
+ */
+import { z } from "zod";
+export interface S3Config {
+    /** AWS region (from AWS_REGION env var, defaults to us-east-1) */
+    region: string;
+    /** Optional custom endpoint (for MinIO, LocalStack, etc.) */
+    endpoint?: string | undefined;
+    /**
+     * Access key ID (from AWS_ACCESS_KEY_ID env var).
+     * Optional: when absent, the AWS SDK default credential provider chain
+     * (SSO, IAM roles/IMDS, shared config profiles, etc.) is used instead.
+     */
+    accessKeyId?: string | undefined;
+    /** Secret access key (from AWS_SECRET_ACCESS_KEY env var). Optional; see accessKeyId. */
+    secretAccessKey?: string | undefined;
+    /**
+     * Session token (from AWS_SESSION_TOKEN env var) for STS/SSO temporary
+     * credentials. Present only alongside a temporary access key/secret pair.
+     */
+    sessionToken?: string | undefined;
+}
+export declare const S3UploadInputSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    key: z.ZodString;
+    body: z.ZodString;
+    contentType: z.ZodOptional<z.ZodString>;
+    base64: z.ZodOptional<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}>;
+export type S3UploadInput = z.infer<typeof S3UploadInputSchema>;
+export interface S3UploadOutput {
+    /** ETag of uploaded object */
+    etag: string;
+    /** Version ID if bucket versioning is enabled */
+    versionId?: string | undefined;
+    /** Full S3 URI */
+    location: string;
+}
+export declare const S3DownloadInputSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    key: z.ZodString;
+    encoding: z.ZodOptional<z.ZodString>;
+    versionId: z.ZodOptional<z.ZodString>;
+    destPath: z.ZodOptional<z.ZodString>;
+    maxBytes: z.ZodOptional<z.ZodNumber>;
+}>;
+export type S3DownloadInput = z.infer<typeof S3DownloadInputSchema>;
+export interface S3DownloadOutput {
+    /** Object content (string if encoding specified, base64 otherwise); empty when destPath was given */
+    body: string;
+    /** The file the object was written to, when destPath was given */
+    path?: string | undefined;
+    /** Content length in bytes */
+    contentLength: number;
+    /** Content type */
+    contentType?: string | undefined;
+    /** ETag of object */
+    etag?: string | undefined;
+    /** Last modified date as ISO string */
+    lastModified?: string | undefined;
+}
+export declare const S3ListInputSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    prefix: z.ZodOptional<z.ZodString>;
+    maxKeys: z.ZodOptional<z.ZodNumber>;
+    continuationToken: z.ZodOptional<z.ZodString>;
+    delimiter: z.ZodOptional<z.ZodString>;
+}>;
+export type S3ListInput = z.infer<typeof S3ListInputSchema>;
+export interface S3ListObject {
+    /** Object key */
+    key: string;
+    /** Size in bytes */
+    size: number;
+    /** Last modified date as ISO string */
+    lastModified: string;
+    /** ETag */
+    etag: string;
+    /** Storage class */
+    storageClass?: string | undefined;
+}
+export interface S3ListOutput {
+    /** List of objects */
+    contents: S3ListObject[];
+    /** Common prefixes (when using delimiter) */
+    commonPrefixes: string[];
+    /** Whether there are more results */
+    isTruncated: boolean;
+    /** Token for next page of results */
+    nextContinuationToken?: string | undefined;
+    /** Number of keys returned */
+    keyCount: number;
+}
+export declare const S3ListAllInputSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    prefix: z.ZodOptional<z.ZodString>;
+    maxKeys: z.ZodOptional<z.ZodNumber>;
+    delimiter: z.ZodOptional<z.ZodString>;
+}>;
+export type S3ListAllInput = z.infer<typeof S3ListAllInputSchema>;
+export interface S3ListAllOutput {
+    /** All objects across every page (not capped at 1000) */
+    contents: S3ListObject[];
+    /** Deduplicated common prefixes across all pages (when using delimiter) */
+    commonPrefixes: string[];
+    /** Total number of keys returned */
+    keyCount: number;
+    /** Number of underlying ListObjectsV2 requests made */
+    pageCount: number;
+}
+export declare const S3DeleteInputSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    key: z.ZodString;
+    versionId: z.ZodOptional<z.ZodString>;
+}>;
+export type S3DeleteInput = z.infer<typeof S3DeleteInputSchema>;
+export interface S3DeleteOutput {
+    /** Whether deletion was successful */
+    deleted: boolean;
+    /** Delete marker if versioning enabled */
+    deleteMarker?: boolean | undefined;
+    /** Version ID of delete marker */
+    versionId?: string | undefined;
+}
+export declare const S3MultipartInitInputSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    key: z.ZodString;
+    contentType: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}>;
+export type S3MultipartInitInput = z.infer<typeof S3MultipartInitInputSchema>;
+export interface S3MultipartInitOutput {
+    /** Upload ID for subsequent part uploads */
+    uploadId: string;
+    /** Bucket name */
+    bucket: string;
+    /** Object key */
+    key: string;
+}
+export declare const S3MultipartUploadInputSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    key: z.ZodString;
+    uploadId: z.ZodString;
+    partNumber: z.ZodNumber;
+    body: z.ZodString;
+}>;
+export type S3MultipartUploadInput = z.infer<typeof S3MultipartUploadInputSchema>;
+export interface S3MultipartUploadOutput {
+    /** ETag of uploaded part */
+    etag: string;
+    /** Part number */
+    partNumber: number;
+}
+export declare const S3MultipartCompleteInputSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    key: z.ZodString;
+    uploadId: z.ZodString;
+    parts: z.ZodArray<z.ZodObject<{
+        etag: z.ZodString;
+        partNumber: z.ZodNumber;
+    }>>;
+}>;
+export type S3MultipartCompleteInput = z.infer<typeof S3MultipartCompleteInputSchema>;
+export interface S3MultipartCompleteOutput {
+    /** Location URL of completed object */
+    location: string;
+    /** Bucket name */
+    bucket: string;
+    /** Object key */
+    key: string;
+    /** ETag of completed object */
+    etag: string;
+}
+export declare const S3MultipartAbortInputSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    key: z.ZodString;
+    uploadId: z.ZodString;
+}>;
+export type S3MultipartAbortInput = z.infer<typeof S3MultipartAbortInputSchema>;
+export interface S3MultipartAbortOutput {
+    /** Whether abort was successful */
+    aborted: boolean;
+}
+export declare const S3UploadOutputSchema: z.ZodType<S3UploadOutput>;
+export declare const S3DownloadOutputSchema: z.ZodType<S3DownloadOutput>;
+export declare const S3ListOutputSchema: z.ZodType<S3ListOutput>;
+export declare const S3ListAllOutputSchema: z.ZodType<S3ListAllOutput>;
+export declare const S3DeleteOutputSchema: z.ZodType<S3DeleteOutput>;
+export declare const S3MultipartInitOutputSchema: z.ZodType<S3MultipartInitOutput>;
+export declare const S3MultipartUploadOutputSchema: z.ZodType<S3MultipartUploadOutput>;
+export declare const S3MultipartCompleteOutputSchema: z.ZodType<S3MultipartCompleteOutput>;
+export declare const S3MultipartAbortOutputSchema: z.ZodType<S3MultipartAbortOutput>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,197 @@
+/**
+ * Type definitions for client-s3 procedures
+ *
+ * AWS S3 operations: upload, download, list, delete, multipart upload
+ * Credentials are loaded from environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY)
+ */
+import { z } from "zod";
+// =============================================================================
+// s3.upload Types
+// =============================================================================
+export const S3UploadInputSchema = z.object({
+    /** S3 bucket name */
+    bucket: z.string().describe("S3 bucket name"),
+    /** Object key (path in bucket) */
+    key: z.string().describe("Object key (path in bucket)"),
+    /** Content to upload - string or base64 encoded binary */
+    body: z.string().describe("Content to upload - string or base64 encoded binary"),
+    /** Content type (e.g., "application/json", "text/plain") */
+    contentType: z.string().optional().describe("Content type (e.g., \"application/json\", \"text/plain\")"),
+    /** If true, body is base64 encoded binary data */
+    base64: z.boolean().optional().describe("If true, body is base64 encoded binary data"),
+    /** Optional metadata key-value pairs */
+    metadata: z.record(z.string(), z.string()).optional().describe("Optional metadata key-value pairs"),
+});
+// =============================================================================
+// s3.download Types
+// =============================================================================
+export const S3DownloadInputSchema = z.object({
+    /** S3 bucket name */
+    bucket: z.string().describe("S3 bucket name"),
+    /** Object key (path in bucket) */
+    key: z.string().describe("Object key (path in bucket)"),
+    /** Encoding for text content (utf8, ascii, etc.) - omit for base64 binary */
+    encoding: z.string().optional().describe("Encoding for text content (utf8, ascii, etc.) - omit for base64 binary"),
+    /** Specific version to download */
+    versionId: z.string().optional().describe("Specific version to download"),
+    /** Write the object to this file instead of returning it (streams to disk: no size limit, no base64) */
+    destPath: z.string().optional().describe("Write the object to this file instead of returning it (streams to disk: no size limit, no base64)"),
+    /** Largest object to load into memory when destPath is not set (default: 64 MiB) */
+    maxBytes: z.number().int().positive().optional().describe("Largest object to load into memory when destPath is not set (default: 64 MiB)"),
+});
+// =============================================================================
+// s3.list Types
+// =============================================================================
+export const S3ListInputSchema = z.object({
+    /** S3 bucket name */
+    bucket: z.string().describe("S3 bucket name"),
+    /** Filter objects by prefix */
+    prefix: z.string().optional().describe("Filter objects by prefix"),
+    /** Maximum number of keys to return (default 1000) */
+    maxKeys: z.number().optional().describe("Maximum number of keys to return (default 1000)"),
+    /** Continuation token for pagination */
+    continuationToken: z.string().optional().describe("Continuation token for pagination"),
+    /** Delimiter for hierarchical listing (e.g., "/") */
+    delimiter: z.string().optional().describe("Delimiter for hierarchical listing (e.g., \"/\")"),
+});
+// =============================================================================
+// s3.listAll Types
+// =============================================================================
+export const S3ListAllInputSchema = z.object({
+    /** S3 bucket name */
+    bucket: z.string().describe("S3 bucket name"),
+    /** Filter objects by prefix */
+    prefix: z.string().optional().describe("Filter objects by prefix"),
+    /** Page size for each underlying request (default/max 1000); paging is automatic */
+    maxKeys: z.number().optional().describe("Page size for each underlying request (default/max 1000); paging is automatic"),
+    /** Delimiter for hierarchical listing (e.g., "/") */
+    delimiter: z.string().optional().describe("Delimiter for hierarchical listing (e.g., \"/\")"),
+});
+// =============================================================================
+// s3.delete Types
+// =============================================================================
+export const S3DeleteInputSchema = z.object({
+    /** S3 bucket name */
+    bucket: z.string().describe("S3 bucket name"),
+    /** Object key (path in bucket) */
+    key: z.string().describe("Object key (path in bucket)"),
+    /** Specific version to delete */
+    versionId: z.string().optional().describe("Specific version to delete"),
+});
+// =============================================================================
+// s3.multipart.init Types
+// =============================================================================
+export const S3MultipartInitInputSchema = z.object({
+    /** S3 bucket name */
+    bucket: z.string().describe("S3 bucket name"),
+    /** Object key (path in bucket) */
+    key: z.string().describe("Object key (path in bucket)"),
+    /** Content type */
+    contentType: z.string().optional().describe("Content type"),
+    /** Optional metadata */
+    metadata: z.record(z.string(), z.string()).optional().describe("Optional metadata"),
+});
+// =============================================================================
+// s3.multipart.upload Types
+// =============================================================================
+export const S3MultipartUploadInputSchema = z.object({
+    /** S3 bucket name */
+    bucket: z.string().describe("S3 bucket name"),
+    /** Object key */
+    key: z.string().describe("Object key"),
+    /** Upload ID from init */
+    uploadId: z.string().describe("Upload ID from init"),
+    /** Part number (1-10000) */
+    partNumber: z.number().min(1).max(10000).describe("Part number (1-10000)"),
+    /** Part content - base64 encoded */
+    body: z.string().describe("Part content - base64 encoded"),
+});
+// =============================================================================
+// s3.multipart.complete Types
+// =============================================================================
+export const S3MultipartCompleteInputSchema = z.object({
+    /** S3 bucket name */
+    bucket: z.string().describe("S3 bucket name"),
+    /** Object key */
+    key: z.string().describe("Object key"),
+    /** Upload ID from init */
+    uploadId: z.string().describe("Upload ID from init"),
+    /** Parts to complete (etag and partNumber) */
+    parts: z.array(z.object({
+        etag: z.string(),
+        partNumber: z.number(),
+    })).describe("Parts to complete (etag and partNumber)"),
+});
+// =============================================================================
+// s3.multipart.abort Types
+// =============================================================================
+export const S3MultipartAbortInputSchema = z.object({
+    /** S3 bucket name */
+    bucket: z.string().describe("S3 bucket name"),
+    /** Object key */
+    key: z.string().describe("Object key"),
+    /** Upload ID to abort */
+    uploadId: z.string().describe("Upload ID to abort"),
+});
+// =============================================================================
+// Output schemas (roadmap 2.1)
+// =============================================================================
+// Loose objects: a field that a schema does not name stays in the result (a strict schema would
+// remove it when the output is validated).
+export const S3UploadOutputSchema = z.looseObject({
+    etag: z.string().describe("The ETag of the object, without quotes"),
+    versionId: z.string().optional().describe("The version id, when the bucket has versioning"),
+    location: z.string().describe("The S3 URI of the object (s3://bucket/key)"),
+});
+export const S3DownloadOutputSchema = z.looseObject({
+    body: z.string().describe("The content: text with an encoding, base64 without one, empty with destPath"),
+    path: z.string().optional().describe("The file that holds the object, with destPath"),
+    contentLength: z.number().describe("The size of the object, in bytes"),
+    contentType: z.string().optional().describe("The content type"),
+    etag: z.string().optional().describe("The ETag of the object, without quotes"),
+    lastModified: z.string().optional().describe("The time of the last change (ISO 8601)"),
+});
+const listObject = z.looseObject({
+    key: z.string().describe("The object key"),
+    size: z.number().describe("The size, in bytes"),
+    lastModified: z.string().describe("The time of the last change (ISO 8601)"),
+    etag: z.string().describe("The ETag, without quotes"),
+    storageClass: z.string().optional().describe("The storage class"),
+});
+export const S3ListOutputSchema = z.looseObject({
+    contents: z.array(listObject).describe("The objects of the page"),
+    commonPrefixes: z.array(z.string()).describe("The common prefixes (with a delimiter)"),
+    isTruncated: z.boolean().describe("True when more pages exist"),
+    nextContinuationToken: z.string().optional().describe("The token of the next page"),
+    keyCount: z.number().describe("The number of keys on the page"),
+});
+export const S3ListAllOutputSchema = z.looseObject({
+    contents: z.array(listObject).describe("The objects of all pages"),
+    commonPrefixes: z.array(z.string()).describe("The common prefixes of all pages (with a delimiter)"),
+    keyCount: z.number().describe("The number of keys"),
+    pageCount: z.number().describe("The number of list requests"),
+});
+export const S3DeleteOutputSchema = z.looseObject({
+    deleted: z.boolean().describe("True when the delete succeeded"),
+    deleteMarker: z.boolean().optional().describe("True when versioning made a delete marker"),
+    versionId: z.string().optional().describe("The version id of the delete marker"),
+});
+export const S3MultipartInitOutputSchema = z.looseObject({
+    uploadId: z.string().describe("The upload id: the part uploads and complete take it"),
+    bucket: z.string().describe("The bucket"),
+    key: z.string().describe("The object key"),
+});
+export const S3MultipartUploadOutputSchema = z.looseObject({
+    etag: z.string().describe("The ETag of the part, without quotes: complete takes it"),
+    partNumber: z.number().describe("The part number"),
+});
+export const S3MultipartCompleteOutputSchema = z.looseObject({
+    location: z.string().describe("The location of the object"),
+    bucket: z.string().describe("The bucket"),
+    key: z.string().describe("The object key"),
+    etag: z.string().describe("The ETag of the object, without quotes"),
+});
+export const S3MultipartAbortOutputSchema = z.looseObject({
+    aborted: z.boolean().describe("True when the upload was aborted"),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,80 @@
 {
+  "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/s3",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "AWS S3 as typed procedures: upload, download with safe part files, list, delete and multipart uploads.",
+  "keywords": [
+    "s3",
+    "aws",
+    "storage",
+    "upload",
+    "procedures"
+  ],
+  "homepage": "https://mark1russell7.github.io/client/",
+  "bugs": {
+    "url": "https://github.com/mark1russell7/client/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark1russell7/client.git",
+    "directory": "packages/client-s3"
+  },
+  "license": "MIT",
+  "author": "Mark Russell (https://github.com/mark1russell7)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./module": {
+      "types": "./dist/module.d.ts",
+      "import": "./dist/module.js"
+    },
+    "./register.js": {
+      "import": "./dist/register.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "./dist/index.js",
+    "./dist/register.js"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.705.0",
+    "@procedures/client": "0.1.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "@types/node": "^22.0.0",
+    "@mark1russell7/cue": "^1.0.0",
+    "vitest": "^5.0.3"
+  },
+  "client": {
+    "procedures": "./dist/register.js"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
 }

package/src/index.ts

@@ -0,0 +1,73 @@
+/**
+ * client-s3 - AWS S3 procedures for the client ecosystem
+ *
+ * Provides upload, download, list, delete, and multipart upload operations.
+ * Credentials are loaded from environment variables (all optional — when the
+ * static keys are absent the AWS SDK default credential provider chain is used):
+ * - AWS_ACCESS_KEY_ID (optional; pair with AWS_SECRET_ACCESS_KEY)
+ * - AWS_SECRET_ACCESS_KEY (optional)
+ * - AWS_SESSION_TOKEN (optional, for STS/SSO temporary credentials)
+ * - AWS_REGION (optional, defaults to us-east-1)
+ * - S3_ENDPOINT (optional, for MinIO/LocalStack)
+ */
+
+// Importing the package registers its procedures, as in the other client packages (BUGS-2026-07 H18)
+import "./register.js";
+
+// Re-export types
+export type {
+  S3Config,
+  S3UploadInput,
+  S3UploadOutput,
+  S3DownloadInput,
+  S3DownloadOutput,
+  S3ListInput,
+  S3ListOutput,
+  S3ListObject,
+  S3ListAllInput,
+  S3ListAllOutput,
+  S3DeleteInput,
+  S3DeleteOutput,
+  S3MultipartInitInput,
+  S3MultipartInitOutput,
+  S3MultipartUploadInput,
+  S3MultipartUploadOutput,
+  S3MultipartCompleteInput,
+  S3MultipartCompleteOutput,
+  S3MultipartAbortInput,
+  S3MultipartAbortOutput,
+} from "./types.js";
+
+// Re-export schemas for external use
+export {
+  S3UploadInputSchema,
+  S3DownloadInputSchema,
+  S3ListInputSchema,
+  S3ListAllInputSchema,
+  S3DeleteInputSchema,
+  S3MultipartInitInputSchema,
+  S3MultipartUploadInputSchema,
+  S3MultipartCompleteInputSchema,
+  S3MultipartAbortInputSchema,
+} from "./types.js";
+
+// Re-export S3 client utilities
+export {
+  getS3Config,
+  createS3Client,
+  getS3Client,
+  resetS3Client,
+} from "./s3-client.js";
+
+// Re-export procedure implementations for direct use
+export {
+  s3Upload,
+  s3Download,
+  s3List,
+  s3ListAll,
+  s3Delete,
+  s3MultipartInit,
+  s3MultipartUpload,
+  s3MultipartComplete,
+  s3MultipartAbort,
+} from "./procedures/s3/index.js";