@reventlessdev/rescript-aws-sdk 3.0.0-alpha.1 → 3.0.0-alpha.3

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 3.0.0-alpha.3 (2026-08-03)
+
+### Features
+
+* **outbound:** let an outbound slice read an aggregate, and geocode addresses with it ([867e63e](https://github.com/ReventlessDev/reventless-core/commit/867e63e774ebc8b78b2b19c78645c8a12a8d06f6))
+
+
+# 3.0.0-alpha.2 (2026-08-02)
+
+### Features
+
+* **aws:** S3 GetObject->string binding + structure offload resolver ([1274bcc](https://github.com/ReventlessDev/reventless-core/commit/1274bcce29f8a1b70db362a10585c508710e7b56))
+
+
 # 3.0.0-alpha.1 (2026-08-02)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/rescript-aws-sdk",
-  "version": "3.0.0-alpha.1",
+  "version": "3.0.0-alpha.3",
   "description": "ReScript bindings for aws-sdk",
   "license": "Apache-2.0",
   "dependencies": {
@@ -9,6 +9,7 @@
     "@aws-sdk/client-dynamodb": "^3.1033.0",
     "@aws-sdk/client-ecs": "^3.1033.0",
     "@aws-sdk/client-kinesis": "^3.1033.0",
+    "@aws-sdk/client-location": "^3.970.0",
     "@aws-sdk/client-resource-groups-tagging-api": "^3.1033.0",
     "@aws-sdk/client-s3": "^3.1033.0",
     "@aws-sdk/client-secrets-manager": "^3.1033.0",
@@ -18,7 +19,7 @@
     "@aws-sdk/lib-dynamodb": "^3.1033.0",
     "@aws-sdk/lib-storage": "^3.1033.0",
     "@smithy/node-http-handler": "^4.5.3",
-    "@reventlessdev/rescript-node": "2.0.0-alpha.0"
+    "@reventlessdev/rescript-node": "2.0.0-alpha.1"
   },
   "devDependencies": {
     "rescript": "12.3.0"

package/src/Location.res

@@ -0,0 +1,80 @@
+// Bindings for Amazon Location Service (`@aws-sdk/client-location`).
+//
+// Both callers of this service want different things from the same call, which
+// is why the bindings live here rather than inside either of them: the browser's
+// geocoder Function URL wants a best-effort list to show a human, and an
+// unattended translator wants to know *how sure* the service is before it writes
+// a coordinate into an event log.
+
+type client
+
+module Raw = {
+  @module("@aws-sdk/client-location") @new
+  external client: unit => client = "LocationClient"
+}
+
+let clientInstance = ref(None)
+
+let client = () => {
+  switch clientInstance.contents {
+  | None =>
+    let c = Raw.client()
+    clientInstance := Some(c)
+    c
+  | Some(c) => c
+  }
+}
+
+module SearchPlaceIndexForTextCommand = {
+  /*** see: https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/location/command/SearchPlaceIndexForTextCommand/ */
+
+  type t
+
+  /** GeoJSON order — `[lng, lat]`, longitude first. Read it through
+      `Geometry.point` rather than indexing it at a call site; the order is the
+      single most reliable source of wrong-hemisphere markers in this domain. */
+  type point = array<float>
+
+  type geometry = {@as("Point") point?: point}
+
+  type place = {
+    @as("Label") label?: string,
+    @as("Geometry") geometry?: geometry,
+    @as("Country") country?: string,
+    @as("PostalCode") postalCode?: string,
+    @as("Municipality") municipality?: string,
+  }
+
+  type result = {
+    @as("Place") place?: place,
+    /** How well this result matches the query, 0…1 — present on results from
+        Esri and HERE index configurations and absent on some others, which is
+        why it is optional rather than defaulted. A caller that treats an absent
+        relevance as a perfect match is asserting something the service did not
+        say. */
+    @as("Relevance") relevance?: float,
+  }
+
+  type input = {
+    @as("IndexName") indexName: string,
+    @as("Text") text: string,
+    @as("MaxResults") maxResults?: int,
+    @as("Language") language?: string,
+    @as("FilterCountries") filterCountries?: array<string>,
+  }
+
+  type output = {
+    @as("$metadata") metadata: Metadata.t,
+    @as("Results") results?: array<result>,
+  }
+
+  @new @module("@aws-sdk/client-location")
+  external make: input => t = "SearchPlaceIndexForTextCommand"
+
+  module Raw = {
+    @send
+    external send: (client, t) => promise<output> = "send"
+  }
+
+  let send: t => promise<output> = input => Raw.send(client(), input)
+}

package/src/Location.res.mjs

@@ -0,0 +1,39 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Primitive_option from "@rescript/runtime/lib/es6/Primitive_option.js";
+import * as ClientLocation from "@aws-sdk/client-location";
+
+let Raw = {};
+
+let clientInstance = {
+  contents: undefined
+};
+
+function client() {
+  let c = clientInstance.contents;
+  if (c !== undefined) {
+    return Primitive_option.valFromOption(c);
+  }
+  let c$1 = new ClientLocation.LocationClient();
+  clientInstance.contents = Primitive_option.some(c$1);
+  return c$1;
+}
+
+let Raw$1 = {};
+
+function send(input) {
+  return client().send(input);
+}
+
+let SearchPlaceIndexForTextCommand = {
+  Raw: Raw$1,
+  send: send
+};
+
+export {
+  Raw,
+  clientInstance,
+  client,
+  SearchPlaceIndexForTextCommand,
+}
+/* @aws-sdk/client-location Not a pure module */

package/src/S3.res

@@ -46,6 +46,16 @@ module GetObjectCommand = {
   }
 
   let send: t => promise<output> = input => Raw.send(client(), input)
+
+  // AWS SDK v3 returns the object body as an SdkStream that adds
+  // `transformToString()` (UTF-8 by default) on top of the Node Readable the
+  // output type reflects. Bind the method here rather than inline at the call site.
+  @send
+  external transformToString: NodeStreams.Readable.t => promise<string> = "transformToString"
+
+  /** Fetch an object and return its body as a UTF-8 string. */
+  let getString: (~bucket: string, ~key: string) => promise<string> = (~bucket, ~key) =>
+    make({bucket, key})->send->Promise.then(output => output.body->transformToString)
 }
 
 module ListObjectVersionsCommand = {

package/src/S3.res.mjs

@@ -25,9 +25,18 @@ function send(input) {
   return client().send(input);
 }
 
+function getString(bucket, key) {
+  let input = new ClientS3.GetObjectCommand({
+    Bucket: bucket,
+    Key: key
+  });
+  return client().send(input).then(output => output.Body.transformToString());
+}
+
 let GetObjectCommand = {
   Raw: Raw$1,
-  send: send
+  send: send,
+  getString: getString
 };
 
 let Raw$2 = {};