@superdurable/connector-hackernews 0.1.0 → 0.2.0

package/dex-connector.json

@@ -4,13 +4,22 @@
   "package": {
     "ecosystem": "npm",
     "name": "@superdurable/connector-hackernews",
-    "version": "0.1.0"
+    "version": "0.2.0"
   },
   "factories": [
     {
       "name": "newListStoryIDsStep",
       "kind": "query",
       "operationId": "listStoryIDs",
+      "inputType": "ListStoryIDsInput",
+      "description": "List current Hacker News story IDs in feed order. Choose feed top, best, new, ask (Ask HN), or show (Show HN), and limit from 1 to 500. Read each returned ID as a Hacker News item for its title and links.",
+      "agent": {
+        "exposed": true,
+        "branches": {
+          "defect": "rejected",
+          "providerRejected": "rejected"
+        }
+      },
       "fields": {
         "stepType": "stepType",
         "annotations": "annotations",
@@ -38,12 +47,41 @@
           "field": "defect",
           "optional": true
         }
-      ]
+      ],
+      "inputSchema": {
+        "additionalProperties": false,
+        "description": "ListStoryIDsInput selects one feed snapshot. It does not select a historical time window.",
+        "properties": {
+          "feed": {
+            "description": "Feed is top, best, new, ask, or show. Empty selects top.",
+            "type": "string"
+          },
+          "limit": {
+            "description": "Limit bounds returned IDs from 1 through 500. Zero selects 50.",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "feed",
+          "limit"
+        ],
+        "type": "object"
+      }
     },
     {
       "name": "newGetItemStep",
       "kind": "query",
       "operationId": "getItem",
+      "inputType": "GetItemInput",
+      "description": "Read one public Hacker News story, comment, job, or poll by its positive item ID. Returns title, author, score, source URL, discussion URL, text as untrusted HTML, and child comment IDs to read next.",
+      "agent": {
+        "exposed": true,
+        "branches": {
+          "defect": "rejected",
+          "notFound": "rejected",
+          "providerRejected": "rejected"
+        }
+      },
       "fields": {
         "stepType": "stepType",
         "annotations": "annotations",
@@ -76,7 +114,21 @@
           "field": "defect",
           "optional": true
         }
-      ]
+      ],
+      "inputSchema": {
+        "additionalProperties": false,
+        "description": "GetItemInput identifies one story, comment, job, poll, or poll option.",
+        "properties": {
+          "id": {
+            "description": "ID is a positive Hacker News item ID.",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "id"
+        ],
+        "type": "object"
+      }
     }
   ]
 }

package/dist/{chunk-KZXAW7VV.js → chunk-23APJHSI.js}

@@ -1,3 +1,62 @@
+// src/generated/models.ts
+import { z } from "zod";
+var goTimeJSONPattern = /^(\d{4})-(\d{2})-(\d{2})T(\d{1,2}):(\d{2}):(\d{2})(?:[.,](\d+))?(Z|([+-])(\d{2}):(\d{2}))$/;
+function isGoTimeJSON(value) {
+  const match = goTimeJSONPattern.exec(value);
+  if (!match) return false;
+  const [, yearText, monthText, dayText, hourText, minuteText, secondText, , zone, , zoneHourText, zoneMinuteText] = match;
+  const year = Number(yearText);
+  const month = Number(monthText);
+  const day = Number(dayText);
+  const isLeap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+  const monthDays = [31, isLeap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+  return month >= 1 && month <= 12 && day >= 1 && day <= monthDays[month - 1] && Number(hourText) <= 23 && Number(minuteText) <= 59 && Number(secondText) <= 59 && (zone === "Z" || Number(zoneHourText) <= 24 && Number(zoneMinuteText) <= 60);
+}
+function canonicalGoTimeJSON(value) {
+  const match = goTimeJSONPattern.exec(value);
+  const [, year, month, day, hour, minute, second, fraction, zone, sign, zoneHour, zoneMinute] = match;
+  const clock = year + "-" + month + "-" + day + "T" + hour.padStart(2, "0") + ":" + minute + ":" + second;
+  const digits = (fraction ?? "").slice(0, 9).replace(/0+$/, "");
+  const offsetMinutes = zone === "Z" ? 0 : (Number(zoneHour) * 60 + Number(zoneMinute)) * (sign === "+" ? 1 : -1);
+  if (Math.abs(offsetMinutes) >= 1440) return value;
+  const offset = offsetMinutes === 0 ? "Z" : (offsetMinutes > 0 ? "+" : "-") + String(Math.floor(Math.abs(offsetMinutes) / 60)).padStart(2, "0") + ":" + String(Math.abs(offsetMinutes) % 60).padStart(2, "0");
+  return clock + (digits ? "." + digits : "") + offset;
+}
+var GoTimeJSONSchema = z.string().refine(isGoTimeJSON, "invalid Go time.Time JSON timestamp").transform(canonicalGoTimeJSON);
+var ConfigSchema = z.object({
+  "baseUrl": z.string().optional(),
+  "timeoutMs": z.number().int().optional(),
+  "maxResponseBytes": z.number().int().optional()
+});
+var ListStoryIDsInputSchema = z.strictObject({
+  "feed": z.string(),
+  "limit": z.number().int()
+});
+var StoryIDsSchema = z.strictObject({
+  "ids": z.array(z.number().int()).nullable(),
+  "hasMore": z.boolean(),
+  "observedAt": GoTimeJSONSchema
+});
+var GetItemInputSchema = z.strictObject({
+  "id": z.number().int()
+});
+var ItemSchema = z.strictObject({
+  "id": z.number().int(),
+  "type": z.string(),
+  "by": z.string().optional(),
+  "time": z.number().int().optional(),
+  "title": z.string().optional(),
+  "text": z.string().optional(),
+  "url": z.string().optional(),
+  "discussionUrl": z.string(),
+  "score": z.number().int().optional(),
+  "descendants": z.number().int().optional(),
+  "parent": z.number().int().optional(),
+  "kids": z.array(z.number().int()).optional(),
+  "deleted": z.boolean().optional(),
+  "dead": z.boolean().optional()
+});
+
 // src/generated/definitions.ts
 var ConnectorID = "hacker-news-daily";
 var ProviderID = "hacker-news";
@@ -78,6 +137,10 @@ function newProjectConnection(project, connectionName, createClient) {
 }
 
 export {
+  ListStoryIDsInputSchema,
+  StoryIDsSchema,
+  GetItemInputSchema,
+  ItemSchema,
   ConnectorID,
   ProviderID,
   ListStoryIDsBranch,

package/dist/{connection-BabsoorY.d.ts → connection-fC9QqgNx.d.ts}

@@ -1,4 +1,5 @@
 import { Query, ConnectionRef } from '@superdurable/connectors-sdk';
+import { z } from 'zod';
 
 /** Connector configuration; omitted fields use manifest defaults. */
 interface Config {
@@ -65,6 +66,15 @@ interface Item {
     /** Dead reports a moderated item. GetItem selects notFound instead of returning it. */
     "dead"?: boolean | undefined;
 }
+/** Runtime validator for ListStoryIDsInput. */
+declare const ListStoryIDsInputSchema: z.ZodObject<{
+    feed: z.ZodString;
+    limit: z.ZodNumber;
+}, z.core.$strict>;
+/** Runtime validator for GetItemInput. */
+declare const GetItemInputSchema: z.ZodObject<{
+    id: z.ZodNumber;
+}, z.core.$strict>;
 
 /** Typed operations supplied by a client or mock. */
 interface Operations {
@@ -87,4 +97,4 @@ declare function newConnection(client: Operations, reference: ConnectionRef): Co
 /** Bind scripted operations to a named connection. */
 declare function newConnectionWithOperations(operations: Operations, reference: ConnectionRef): Connection;
 
-export { Connection as C, type GetItemInput as G, type Item as I, type ListStoryIDsInput as L, type Operations as O, type StoryIDs as S, type Config as a, type Credentials as b, newConnectionWithOperations as c, newConnection as n };
+export { Connection as C, type GetItemInput as G, type Item as I, type ListStoryIDsInput as L, type Operations as O, type StoryIDs as S, type Config as a, type Credentials as b, GetItemInputSchema as c, ListStoryIDsInputSchema as d, newConnectionWithOperations as e, newConnection as n };

package/dist/hackernewsmock.d.ts

@@ -1,6 +1,7 @@
 import { MockQuery, Case } from '@superdurable/connectors-sdk/connectormock';
 import { Failure } from '@superdurable/connectors-sdk';
-import { O as Operations, C as Connection, L as ListStoryIDsInput, S as StoryIDs, G as GetItemInput, I as Item } from './connection-BabsoorY.js';
+import { O as Operations, C as Connection, L as ListStoryIDsInput, S as StoryIDs, G as GetItemInput, I as Item } from './connection-fC9QqgNx.js';
+import 'zod';
 
 /** Go zero value for ListStoryIDsInput in scripted cases. */
 declare const emptyListStoryIDsInput: ListStoryIDsInput;

package/dist/hackernewsmock.js

@@ -1,74 +1,17 @@
 import {
   ConnectorID,
   GetItemDefinition,
+  GetItemInputSchema,
+  ItemSchema,
   ListStoryIDsDefinition,
+  ListStoryIDsInputSchema,
   ProviderID,
+  StoryIDsSchema,
   newConnectionWithOperations
-} from "./chunk-KZXAW7VV.js";
+} from "./chunk-23APJHSI.js";
 
 // src/generated/mock.ts
 import { branchCase, retryCase, newQuery } from "@superdurable/connectors-sdk/connectormock";
-
-// src/generated/models.ts
-import { z } from "zod";
-var goTimeJSONPattern = /^(\d{4})-(\d{2})-(\d{2})T(\d{1,2}):(\d{2}):(\d{2})(?:[.,](\d+))?(Z|([+-])(\d{2}):(\d{2}))$/;
-function isGoTimeJSON(value) {
-  const match = goTimeJSONPattern.exec(value);
-  if (!match) return false;
-  const [, yearText, monthText, dayText, hourText, minuteText, secondText, , zone, , zoneHourText, zoneMinuteText] = match;
-  const year = Number(yearText);
-  const month = Number(monthText);
-  const day = Number(dayText);
-  const isLeap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
-  const monthDays = [31, isLeap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
-  return month >= 1 && month <= 12 && day >= 1 && day <= monthDays[month - 1] && Number(hourText) <= 23 && Number(minuteText) <= 59 && Number(secondText) <= 59 && (zone === "Z" || Number(zoneHourText) <= 24 && Number(zoneMinuteText) <= 60);
-}
-function canonicalGoTimeJSON(value) {
-  const match = goTimeJSONPattern.exec(value);
-  const [, year, month, day, hour, minute, second, fraction, zone, sign, zoneHour, zoneMinute] = match;
-  const clock = year + "-" + month + "-" + day + "T" + hour.padStart(2, "0") + ":" + minute + ":" + second;
-  const digits = (fraction ?? "").slice(0, 9).replace(/0+$/, "");
-  const offsetMinutes = zone === "Z" ? 0 : (Number(zoneHour) * 60 + Number(zoneMinute)) * (sign === "+" ? 1 : -1);
-  if (Math.abs(offsetMinutes) >= 1440) return value;
-  const offset = offsetMinutes === 0 ? "Z" : (offsetMinutes > 0 ? "+" : "-") + String(Math.floor(Math.abs(offsetMinutes) / 60)).padStart(2, "0") + ":" + String(Math.abs(offsetMinutes) % 60).padStart(2, "0");
-  return clock + (digits ? "." + digits : "") + offset;
-}
-var GoTimeJSONSchema = z.string().refine(isGoTimeJSON, "invalid Go time.Time JSON timestamp").transform(canonicalGoTimeJSON);
-var ConfigSchema = z.object({
-  "baseUrl": z.string().optional(),
-  "timeoutMs": z.number().int().optional(),
-  "maxResponseBytes": z.number().int().optional()
-});
-var ListStoryIDsInputSchema = z.strictObject({
-  "feed": z.string(),
-  "limit": z.number().int()
-});
-var StoryIDsSchema = z.strictObject({
-  "ids": z.array(z.number().int()).nullable(),
-  "hasMore": z.boolean(),
-  "observedAt": GoTimeJSONSchema
-});
-var GetItemInputSchema = z.strictObject({
-  "id": z.number().int()
-});
-var ItemSchema = z.strictObject({
-  "id": z.number().int(),
-  "type": z.string(),
-  "by": z.string().optional(),
-  "time": z.number().int().optional(),
-  "title": z.string().optional(),
-  "text": z.string().optional(),
-  "url": z.string().optional(),
-  "discussionUrl": z.string(),
-  "score": z.number().int().optional(),
-  "descendants": z.number().int().optional(),
-  "parent": z.number().int().optional(),
-  "kids": z.array(z.number().int()).optional(),
-  "deleted": z.boolean().optional(),
-  "dead": z.boolean().optional()
-});
-
-// src/generated/mock.ts
 var emptyListStoryIDsInput = ListStoryIDsInputSchema.parse({
   "feed": "",
   "limit": 0

package/dist/index.d.ts

@@ -1,10 +1,11 @@
-import { G as GetItemInput, I as Item, a as Config, L as ListStoryIDsInput, S as StoryIDs, C as Connection, O as Operations } from './connection-BabsoorY.js';
-export { b as Credentials, n as newConnection, c as newConnectionWithOperations } from './connection-BabsoorY.js';
+import { G as GetItemInput, I as Item, a as Config, L as ListStoryIDsInput, S as StoryIDs, C as Connection, O as Operations } from './connection-fC9QqgNx.js';
+export { b as Credentials, c as GetItemInputSchema, d as ListStoryIDsInputSchema, n as newConnection, e as newConnectionWithOperations } from './connection-fC9QqgNx.js';
 import { LoadedProject } from '@superdurable/connectors-sdk/projectconfig';
 import * as _superdurable_connectors_sdk from '@superdurable/connectors-sdk';
 import { Query, Call, QueryAttempt, QueryStepConfig, QueryResult, QueryStep, QueryDefinition } from '@superdurable/connectors-sdk';
 import { ProviderRequest, ProviderResponse } from '@superdurable/connectors-sdk/providerhttp';
 import { StepTarget } from '@superdurable/dex';
+import 'zod';
 
 /** Injectable HTTP sender and clock for deterministic provider replay. */
 interface HackerNewsClientOptions {

package/dist/index.js

@@ -8,6 +8,7 @@ import {
   GetItemBranchNotFound,
   GetItemBranchProviderRejected,
   GetItemDefinition,
+  GetItemInputSchema,
   GetItemMetadata,
   ListStoryIDsBranch,
   ListStoryIDsBranchDefect,
@@ -15,12 +16,13 @@ import {
   ListStoryIDsBranchListed,
   ListStoryIDsBranchProviderRejected,
   ListStoryIDsDefinition,
+  ListStoryIDsInputSchema,
   ListStoryIDsMetadata,
   ProviderID,
   newConnection,
   newConnectionWithOperations,
   newProjectConnection
-} from "./chunk-KZXAW7VV.js";
+} from "./chunk-23APJHSI.js";
 
 // src/index.ts
 import { z } from "zod";
@@ -276,6 +278,7 @@ export {
   GetItemBranchNotFound,
   GetItemBranchProviderRejected,
   GetItemDefinition,
+  GetItemInputSchema,
   GetItemMetadata,
   GetItemOperation,
   HackerNewsClient,
@@ -285,6 +288,7 @@ export {
   ListStoryIDsBranchListed,
   ListStoryIDsBranchProviderRejected,
   ListStoryIDsDefinition,
+  ListStoryIDsInputSchema,
   ListStoryIDsMetadata,
   ListStoryIDsOperation,
   ProviderID,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdurable/connector-hackernews",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "description": "Hacker News connector for Dex TypeScript applications",
   "repository": {
@@ -22,7 +22,8 @@
     "./hackernewsmock": {
       "types": "./dist/hackernewsmock.d.ts",
       "import": "./dist/hackernewsmock.js"
-    }
+    },
+    "./dex-connector.json": "./dex-connector.json"
   },
   "files": [
     "dist",