@withgateway/sdk 0.3.0 → 0.3.1

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.
Files changed (47) hide show
  1. package/README.md +5 -1
  2. package/dist/cli.js +1497 -712
  3. package/dist/cli.js.map +1 -1
  4. package/dist/cli.mjs +1500 -715
  5. package/dist/cli.mjs.map +1 -1
  6. package/dist/files/index.js +34 -0
  7. package/dist/files/index.js.map +1 -1
  8. package/dist/files/index.mjs +34 -0
  9. package/dist/files/index.mjs.map +1 -1
  10. package/dist/{index-DAb-FCMg.d.ts → index-CBqbB_0J.d.ts} +2 -12
  11. package/dist/{index-D6oi1TWE.d.mts → index-D-AMnAMa.d.mts} +2 -12
  12. package/dist/index.d.mts +3 -3
  13. package/dist/index.d.ts +3 -3
  14. package/dist/index.js +173 -50
  15. package/dist/index.js.map +1 -1
  16. package/dist/index.mjs +171 -50
  17. package/dist/index.mjs.map +1 -1
  18. package/dist/traces/index.js +34 -0
  19. package/dist/traces/index.js.map +1 -1
  20. package/dist/traces/index.mjs +34 -0
  21. package/dist/traces/index.mjs.map +1 -1
  22. package/dist/tracing/index.d.mts +1 -1
  23. package/dist/tracing/index.d.ts +1 -1
  24. package/dist/tracing/index.js +39 -20
  25. package/dist/tracing/index.js.map +1 -1
  26. package/dist/tracing/index.mjs +39 -20
  27. package/dist/tracing/index.mjs.map +1 -1
  28. package/dist/worlds/index.d.mts +66 -18
  29. package/dist/worlds/index.d.ts +66 -18
  30. package/dist/worlds/index.js +171 -50
  31. package/dist/worlds/index.js.map +1 -1
  32. package/dist/worlds/index.mjs +171 -50
  33. package/dist/worlds/index.mjs.map +1 -1
  34. package/package.json +1 -1
  35. package/runtime/gatewaysdk/environment/schema/api.py +7 -8
  36. package/runtime/gatewaysdk/environment/schema/cast.py +31 -4
  37. package/runtime/gatewaysdk/environment/schema/platform.py +1 -7
  38. package/runtime/gatewaysdk/environment/schema/skills/connector-schema-authoring/SKILL.md +3 -3
  39. package/runtime/gatewaysdk/environment/schema/skills/world-data-ingestion/SKILL.md +2 -2
  40. package/runtime/gatewaysdk/environment/schema/skills/worlds-getting-started/SKILL.md +6 -6
  41. package/runtime/gatewaysdk/environment/schema/skills/worlds-getting-started/references/cli-mcp-map.md +1 -1
  42. package/skills/connector-schema-authoring/SKILL.md +3 -3
  43. package/skills/connector-schema-authoring/connector-worlds.md +12 -5
  44. package/skills/connector-schema-authoring/world-schema.md +8 -0
  45. package/skills/world-data-ingestion/SKILL.md +2 -2
  46. package/skills/worlds-getting-started/SKILL.md +6 -6
  47. package/skills/worlds-getting-started/references/cli-mcp-map.md +1 -1
@@ -20,7 +20,7 @@ var require_package = __commonJS({
20
20
  "package.json"(exports, module) {
21
21
  module.exports = {
22
22
  name: "@withgateway/sdk",
23
- version: "0.3.0",
23
+ version: "0.3.1",
24
24
  description: "Gateway SDK for TypeScript - A/B experiments, tracing, and observability",
25
25
  main: "./dist/index.js",
26
26
  module: "./dist/index.mjs",
@@ -1160,22 +1160,49 @@ async function registerBuild(params) {
1160
1160
  }
1161
1161
  }
1162
1162
 
1163
- // src/tracing/init.ts
1164
- var ENV_VARS = {
1163
+ // src/tracing/prerequisites.ts
1164
+ var GATEWAY_ENV = {
1165
1165
  HOST: "GATEWAY_HOST",
1166
1166
  PUBLIC_KEY: "GATEWAY_PUBLIC_KEY",
1167
1167
  SECRET_KEY: "GATEWAY_SECRET_KEY",
1168
1168
  ENDPOINT: "GATEWAY_OTLP_ENDPOINT"
1169
1169
  };
1170
+ var OPENTELEMETRY_PEERS = [
1171
+ "@opentelemetry/api",
1172
+ "@opentelemetry/exporter-trace-otlp-http",
1173
+ "@opentelemetry/resources",
1174
+ "@opentelemetry/sdk-trace-base",
1175
+ "@opentelemetry/sdk-trace-node"
1176
+ ];
1177
+ var MODULE_NOT_FOUND = /* @__PURE__ */ new Set(["MODULE_NOT_FOUND", "ERR_MODULE_NOT_FOUND"]);
1178
+ function getEnv(key) {
1179
+ const value = process.env[key];
1180
+ return value ? value : void 0;
1181
+ }
1182
+ function isGatewayConfigured() {
1183
+ return !!(getEnv(GATEWAY_ENV.HOST) && getEnv(GATEWAY_ENV.PUBLIC_KEY) && getEnv(GATEWAY_ENV.SECRET_KEY));
1184
+ }
1185
+ var OpenTelemetryMissing = class _OpenTelemetryMissing extends Error {
1186
+ constructor() {
1187
+ super(
1188
+ `OpenTelemetry packages not found. Install them with:
1189
+ npm install ${OPENTELEMETRY_PEERS.join(" ")}`
1190
+ );
1191
+ this.name = "OpenTelemetryMissing";
1192
+ }
1193
+ static explains(error) {
1194
+ if (error instanceof _OpenTelemetryMissing) return true;
1195
+ const { code, message } = error ?? {};
1196
+ return MODULE_NOT_FOUND.has(String(code)) && String(message).includes("@opentelemetry/");
1197
+ }
1198
+ };
1199
+
1200
+ // src/tracing/init.ts
1170
1201
  var DEFAULT_OTLP_PATH = "/api/public/otel/v1/traces";
1171
1202
  var state = {
1172
1203
  initialized: false,
1173
1204
  provider: null
1174
1205
  };
1175
- function getEnv(key) {
1176
- const value = process.env[key];
1177
- return value ? value : void 0;
1178
- }
1179
1206
  function log(message, ...args) {
1180
1207
  if (state.debug) {
1181
1208
  console.log(`[gatewaysdk.tracing] ${message}`, ...args);
@@ -1185,10 +1212,10 @@ function warn(message, ...args) {
1185
1212
  console.warn(`[gatewaysdk.tracing] ${message}`, ...args);
1186
1213
  }
1187
1214
  function buildProvider(config, logFn) {
1188
- const host = config.host ?? getEnv(ENV_VARS.HOST);
1189
- const publicKey = config.publicKey ?? getEnv(ENV_VARS.PUBLIC_KEY);
1190
- const secretKey = config.secretKey ?? getEnv(ENV_VARS.SECRET_KEY);
1191
- const endpoint = config.endpoint ?? getEnv(ENV_VARS.ENDPOINT) ?? (host ? `${host.replace(/\/$/, "")}${DEFAULT_OTLP_PATH}` : void 0);
1215
+ const host = config.host ?? getEnv(GATEWAY_ENV.HOST);
1216
+ const publicKey = config.publicKey ?? getEnv(GATEWAY_ENV.PUBLIC_KEY);
1217
+ const secretKey = config.secretKey ?? getEnv(GATEWAY_ENV.SECRET_KEY);
1218
+ const endpoint = config.endpoint ?? getEnv(GATEWAY_ENV.ENDPOINT) ?? (host ? `${host.replace(/\/$/, "")}${DEFAULT_OTLP_PATH}` : void 0);
1192
1219
  const missing = [];
1193
1220
  if (!host) missing.push("host (or GATEWAY_HOST env var)");
1194
1221
  if (!publicKey) missing.push("publicKey (or GATEWAY_PUBLIC_KEY env var)");
@@ -1225,9 +1252,7 @@ function buildProvider(config, logFn) {
1225
1252
  ATTR_SERVICE_NAME = "service.name";
1226
1253
  }
1227
1254
  } catch {
1228
- throw new Error(
1229
- "OpenTelemetry packages not found. Install them with:\nnpm install @opentelemetry/sdk-trace-node @opentelemetry/sdk-trace-base @opentelemetry/exporter-trace-otlp-http @opentelemetry/resources"
1230
- );
1255
+ throw new OpenTelemetryMissing();
1231
1256
  }
1232
1257
  const resourceAttrs = {
1233
1258
  [ATTR_SERVICE_NAME]: config.serviceName ?? "gatewaysdk-tracing"
@@ -1433,12 +1458,6 @@ async function shutdown() {
1433
1458
  function isInitialized() {
1434
1459
  return state.initialized;
1435
1460
  }
1436
- function isGatewayConfigured() {
1437
- const host = getEnv(ENV_VARS.HOST);
1438
- const publicKey = getEnv(ENV_VARS.PUBLIC_KEY);
1439
- const secretKey = getEnv(ENV_VARS.SECRET_KEY);
1440
- return !!(host && publicKey && secretKey);
1441
- }
1442
1461
 
1443
1462
  // src/tracing/observe.ts
1444
1463
  import { trace as trace3, context, SpanStatusCode } from "@opentelemetry/api";