@comms-id/asx 0.4.2 → 1.0.0

package/README.md

@@ -2,7 +2,7 @@
 
 Typed client for the Comms.ID ASX API (`https://api.comms.id/asx/v1`): ASX-listed companies: suggest as a user types, and look one up.
 
-`src/` is generated from the ASX contract (`packages/asx-service/openapi/asx.v1.json`) by `@comms-id/forge-transformers`. Do not edit it: change the contract and run `pnpm --filter @comms-id/forge-transformers generate`.
+`src/` is generated from the ASX contract (`packages/asx-service/openapi/asx.v2.json`) by `@comms-id/forge-transformers`. Do not edit it: change the contract and run `pnpm --filter @comms-id/forge-transformers generate`.
 
 ```ts
 import { createAsxClient } from "@comms-id/asx/server";

package/dist/client-replies.d.ts

@@ -157,22 +157,5 @@ export declare const AbnMatchesResponse: Schema.Struct<{
             }>>;
         }>;
     }>>;
-    /** Name-rule matches (#385): a lead for the user to confirm, not issuer proof. */
-    readonly nameMatches: Schema.optionalKey<Schema.$Array<Schema.Struct<{
-        readonly directory: Schema.Struct<{
-            readonly ticker: Schema.String;
-            readonly companyName: Schema.String;
-            readonly industryGroup: Schema.NullOr<Schema.String>;
-            readonly listingDate: Schema.NullOr<Schema.String>;
-            readonly marketCapitalisation: Schema.NullOr<Schema.Number>;
-        }>;
-        readonly nameMatch: Schema.Struct<{
-            readonly abn: Schema.String;
-            readonly acn: Schema.NullOr<Schema.String>;
-            readonly abnEntityName: Schema.NonEmptyString;
-            readonly rule: Schema.Literals<readonly ["full-name", "suffix-removed", "the-moved", "comma-ignored"]>;
-            readonly abnSnapshotDate: Schema.String;
-        }>;
-    }>>>;
 }>;
 export type AbnMatchesReply = typeof AbnMatchesResponse.Type;

package/dist/client-replies.js

@@ -1,7 +1,6 @@
 import { Schema } from "effect";
 import { ConfirmedEnrichment } from "./enrichment.js";
 import { DirectoryEntry, Failure, Observation, Timestamp } from "./model.js";
-import { AbnNameMatch } from "./snapshot.js";
 const Generation = Schema.String.check(Schema.isPattern(/^[a-f0-9]{64}$/));
 export const LookupResponse = Schema.Union([
     Schema.Struct({
@@ -52,6 +51,4 @@ export const SuggestionsResponse = Schema.Union([
 export const AbnMatchesResponse = Schema.Struct({
     ...Saved,
     matches: Schema.Array(Schema.Struct({ directory: DirectoryEntry, enrichment: ConfirmedEnrichment })).check(Schema.isMaxLength(20_000)),
-    /** Name-rule matches (#385): a lead for the user to confirm, not issuer proof. */
-    nameMatches: Schema.optionalKey(Schema.Array(Schema.Struct({ directory: DirectoryEntry, nameMatch: AbnNameMatch })).check(Schema.isMaxLength(20))),
 });

package/dist/company-record.js

@@ -25,7 +25,6 @@ export function mergeCompanyRecord(record, incoming) {
             sources,
             observation: null,
             missingAt: { startedAt: asx.startedAt, observedAt: asx.observedAt },
-            ...(record.abnNameMatch ? { abnNameMatch: structuredClone(record.abnNameMatch) } : {}),
         };
     const company = parseCompany(ticker, asx.payload);
     if (company.sourceId !== asx.sourceId)
@@ -55,6 +54,5 @@ export function mergeCompanyRecord(record, incoming) {
         ...(record.enrichment && validEnrichment(record.enrichment, company)
             ? { enrichment: structuredClone(record.enrichment) }
             : {}),
-        ...(record.abnNameMatch ? { abnNameMatch: structuredClone(record.abnNameMatch) } : {}),
     };
 }

package/dist/descriptor.d.ts

@@ -6,10 +6,10 @@ export declare const asxProduct: {
     readonly operations: readonly [{
         readonly name: "lookup";
         readonly method: "POST";
-        readonly path: "/asx/v1/lookup";
+        readonly path: "/asx/v2/lookup";
     }, {
         readonly name: "suggest";
         readonly method: "POST";
-        readonly path: "/asx/v1/suggest";
+        readonly path: "/asx/v2/suggest";
     }];
 };

package/dist/descriptor.js

@@ -9,12 +9,12 @@ export const asxProduct = {
         {
             "name": "lookup",
             "method": "POST",
-            "path": "/asx/v1/lookup"
+            "path": "/asx/v2/lookup"
         },
         {
             "name": "suggest",
             "method": "POST",
-            "path": "/asx/v1/suggest"
+            "path": "/asx/v2/suggest"
         }
     ],
 };

package/dist/generated/fixtures.js

@@ -2,7 +2,7 @@
 // Every reply is the example in the contract.
 /** LOCAL FIXTURES: one canned reply for each operation path. Fake data. */
 export const fixtures = {
-    "/asx/v1/lookup": {
+    "/asx/v2/lookup": {
         "status": "found",
         "source": "live",
         "observation": {
@@ -45,7 +45,7 @@ export const fixtures = {
             "lastChangedAt": "2026-10-03T01:29:55.678Z"
         }
     },
-    "/asx/v1/suggest": {
+    "/asx/v2/suggest": {
         "source": "live",
         "directoryObservedAt": "2026-10-03T00:00:00.000Z",
         "suggestions": []

package/dist/generated/operations.js

@@ -4,7 +4,7 @@ export const operations = {
     lookup: {
         name: "lookup",
         method: "POST",
-        path: "/asx/v1/lookup",
+        path: "/asx/v2/lookup",
         safeToRetry: true,
         request: {
             "t": "obj",
@@ -452,7 +452,7 @@ export const operations = {
                                 "abn": {
                                     "t": "str"
                                 },
-                                "acn": {
+                                "asicNumber": {
                                     "t": "any_of",
                                     "of": [
                                         {
@@ -464,6 +464,24 @@ export const operations = {
                                         }
                                     ]
                                 },
+                                "asicNumberType": {
+                                    "t": "any_of",
+                                    "of": [
+                                        {
+                                            "t": "str",
+                                            "values": [
+                                                "ACN",
+                                                "ARBN",
+                                                "ARSN",
+                                                "ARFN",
+                                                "undetermined"
+                                            ]
+                                        },
+                                        {
+                                            "t": "null"
+                                        }
+                                    ]
+                                },
                                 "legalName": {
                                     "t": "str",
                                     "min": 1
@@ -575,7 +593,8 @@ export const operations = {
                                 "ticker",
                                 "sourceId",
                                 "abn",
-                                "acn",
+                                "asicNumber",
+                                "asicNumberType",
                                 "legalName",
                                 "identityEvidence",
                                 "abrEvidence",
@@ -650,7 +669,7 @@ export const operations = {
     suggest: {
         name: "suggest",
         method: "POST",
-        path: "/asx/v1/suggest",
+        path: "/asx/v2/suggest",
         safeToRetry: true,
         request: {
             "t": "obj",

package/dist/generated/types.d.ts

@@ -70,7 +70,8 @@ export type LookupResponse = {
         readonly ticker: string;
         readonly sourceId: string;
         readonly abn: string;
-        readonly acn: string | null;
+        readonly asicNumber: string | null;
+        readonly asicNumberType: "ACN" | "ARBN" | "ARSN" | "ARFN" | "undetermined" | null;
         readonly legalName: string;
         readonly identityEvidence: {
             readonly url: string;

package/dist/refresh.js

@@ -140,10 +140,6 @@ export function applyRefresh(previousInput, directoryInput, attemptsInput) {
                 : {}),
             ...(missingAt ? { missingAt } : {}),
             ...(enrichment ? { enrichment } : {}),
-            // A name match belongs to the directory name it was made for (#385).
-            ...(prior?.abnNameMatch && prior.directory.companyName === entry.companyName
-                ? { abnNameMatch: prior.abnNameMatch }
-                : {}),
         };
     });
     return {

package/dist/snapshot.d.ts

@@ -1,20 +1,6 @@
 import { Schema } from "effect";
 import { DirectoryEntry } from "./model.js";
 import { ConfirmedEnrichment } from "./enrichment.js";
-/**
- * An ABN matched to a listed company by the owner-accepted name rules (#385): the
- * full legal name, one trailing company suffix removed, a trailing "(THE)" moved to
- * the front, or a comma ignored. A name match, never proof of issuer identity.
- */
-export declare const AbnNameMatch: Schema.Struct<{
-    readonly abn: Schema.String;
-    readonly acn: Schema.NullOr<Schema.String>;
-    readonly abnEntityName: Schema.NonEmptyString;
-    readonly rule: Schema.Literals<readonly ["full-name", "suffix-removed", "the-moved", "comma-ignored"]>;
-    readonly abnSnapshotDate: Schema.String;
-}>;
-export interface AbnNameMatch extends Schema.Schema.Type<typeof AbnNameMatch> {
-}
 export declare const CompanyRecord: Schema.Struct<{
     readonly directory: Schema.Struct<{
         readonly ticker: Schema.String;
@@ -108,13 +94,6 @@ export declare const CompanyRecord: Schema.Struct<{
             }>;
         }>>;
     }>>;
-    readonly abnNameMatch: Schema.optionalKey<Schema.Struct<{
-        readonly abn: Schema.String;
-        readonly acn: Schema.NullOr<Schema.String>;
-        readonly abnEntityName: Schema.NonEmptyString;
-        readonly rule: Schema.Literals<readonly ["full-name", "suffix-removed", "the-moved", "comma-ignored"]>;
-        readonly abnSnapshotDate: Schema.String;
-    }>>;
     readonly missingAt: Schema.optionalKey<Schema.Struct<{
         readonly startedAt: Schema.String;
         readonly observedAt: Schema.String;
@@ -218,13 +197,6 @@ declare const Dataset: Schema.Struct<{
                 }>;
             }>>;
         }>>;
-        readonly abnNameMatch: Schema.optionalKey<Schema.Struct<{
-            readonly abn: Schema.String;
-            readonly acn: Schema.NullOr<Schema.String>;
-            readonly abnEntityName: Schema.NonEmptyString;
-            readonly rule: Schema.Literals<readonly ["full-name", "suffix-removed", "the-moved", "comma-ignored"]>;
-            readonly abnSnapshotDate: Schema.String;
-        }>>;
         readonly missingAt: Schema.optionalKey<Schema.Struct<{
             readonly startedAt: Schema.String;
             readonly observedAt: Schema.String;
@@ -303,11 +275,6 @@ export interface AsxSnapshot {
         directory: DirectoryEntry;
         enrichment: ConfirmedEnrichment;
     }[];
-    /** Listed companies whose name matches this ABN's entity name under the #385 rules. */
-    readonly findNameMatchesByAbn: (abn: string) => readonly {
-        directory: DirectoryEntry;
-        nameMatch: AbnNameMatch;
-    }[];
     readonly metadata: () => {
         directoryObservedAt: string;
         records: number;

package/dist/snapshot.js

@@ -4,24 +4,11 @@ import { DirectoryEntry, failure, isTimestamp, Observation, validObservation } f
 import { normalizeTicker } from "./parse.js";
 import { ConfirmedEnrichment, validAbn, validEnrichment } from "./enrichment.js";
 import { CompanySources, decodeCompanySources } from "./source-record.js";
-/**
- * An ABN matched to a listed company by the owner-accepted name rules (#385): the
- * full legal name, one trailing company suffix removed, a trailing "(THE)" moved to
- * the front, or a comma ignored. A name match, never proof of issuer identity.
- */
-export const AbnNameMatch = Schema.Struct({
-    abn: Schema.String.check(Schema.makeFilter(validAbn)),
-    acn: Schema.NullOr(Schema.String.check(Schema.isPattern(/^\d{9}$/))),
-    abnEntityName: Schema.NonEmptyString,
-    rule: Schema.Literals(["full-name", "suffix-removed", "the-moved", "comma-ignored"]),
-    abnSnapshotDate: Schema.String.check(Schema.isPattern(/^\d{4}-\d{2}-\d{2}$/)),
-});
 export const CompanyRecord = Schema.Struct({
     directory: DirectoryEntry,
     observation: Schema.NullOr(Observation),
     sources: Schema.optionalKey(CompanySources),
     enrichment: Schema.optionalKey(ConfirmedEnrichment),
-    abnNameMatch: Schema.optionalKey(AbnNameMatch),
     missingAt: Schema.optionalKey(Schema.Struct({ startedAt: Schema.String, observedAt: Schema.String })),
 });
 const Dataset = Schema.Struct({
@@ -131,13 +118,6 @@ export async function openSnapshot(text, expectedGeneration) {
                 ? [{ directory: { ...record.directory }, enrichment: structuredClone(record.enrichment) }]
                 : []);
         },
-        findNameMatchesByAbn: (abn) => {
-            if (typeof abn !== "string" || !validAbn(abn))
-                throw failure("INVALID_INPUT");
-            return dataset.records.flatMap((record) => record.abnNameMatch?.abn === abn
-                ? [{ directory: { ...record.directory }, nameMatch: { ...record.abnNameMatch } }]
-                : []);
-        },
         metadata: () => ({
             directoryObservedAt: dataset.directoryObservedAt,
             records: records.size,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comms-id/asx",
-  "version": "0.4.2",
+  "version": "1.0.0",
   "description": "Typed client for the Comms.ID ASX API: ASX-listed companies: suggest as a user types, and look one up",
   "type": "module",
   "sideEffects": false,

package/dist/contract/http-api.d.ts

@@ -1,139 +0,0 @@
-import { Schema } from "effect";
-import { HttpApi, HttpApiEndpoint, HttpApiGroup, OpenApi } from "effect/unstable/httpapi";
-export declare const ASX_API_MAJOR = 1;
-export declare const ASX_API_PREFIX = "/asx/v1";
-export declare const AsxApi: HttpApi.HttpApi<"asx", HttpApiGroup.HttpApiGroup<"asx", HttpApiEndpoint.HttpApiEndpoint<"lookup", "POST", "/asx/v1/lookup", never, never, Schema.toCodecJson<Schema.Struct<{
-    readonly ticker: Schema.String;
-    readonly mode: Schema.optionalKey<Schema.Literals<readonly ["live", "snapshot", "live-first"]>>;
-}>>, never, Schema.toCodecJson<Schema.Union<readonly [Schema.Struct<{
-    readonly status: Schema.Literal<"found">;
-    readonly source: Schema.Literal<"live">;
-    readonly observation: Schema.Struct<{
-        readonly company: Schema.Struct<{
-            readonly raw: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
-            readonly ticker: Schema.String;
-            readonly sourceId: Schema.String;
-            readonly companyName: Schema.String;
-            readonly address: Schema.NullOr<Schema.String>;
-            readonly tel: Schema.NullOr<Schema.String>;
-            readonly fax: Schema.NullOr<Schema.String>;
-            readonly website: Schema.NullOr<Schema.String>;
-            readonly description: Schema.NullOr<Schema.String>;
-            readonly issueType: Schema.NullOr<Schema.String>;
-            readonly foreignExempt: Schema.NullOr<Schema.Boolean>;
-            readonly people: Schema.$Array<Schema.Struct<{
-                readonly sourceName: Schema.String;
-                readonly displayName: Schema.String;
-                readonly title: Schema.String;
-                readonly sourceCategory: Schema.Literals<readonly ["directors", "secretaries"]>;
-            }>>;
-        }>;
-        readonly startedAt: Schema.String;
-        readonly observedAt: Schema.String;
-        readonly lastChangedAt: Schema.String;
-    }>;
-}>, Schema.Struct<{
-    readonly status: Schema.Literal<"missing">;
-    readonly source: Schema.Literal<"live">;
-    readonly startedAt: Schema.String;
-    readonly observedAt: Schema.String;
-}>, Schema.Struct<{
-    readonly status: Schema.Literal<"found">;
-    readonly source: Schema.Literal<"snapshot">;
-    readonly observation: Schema.Struct<{
-        readonly company: Schema.Struct<{
-            readonly raw: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
-            readonly ticker: Schema.String;
-            readonly sourceId: Schema.String;
-            readonly companyName: Schema.String;
-            readonly address: Schema.NullOr<Schema.String>;
-            readonly tel: Schema.NullOr<Schema.String>;
-            readonly fax: Schema.NullOr<Schema.String>;
-            readonly website: Schema.NullOr<Schema.String>;
-            readonly description: Schema.NullOr<Schema.String>;
-            readonly issueType: Schema.NullOr<Schema.String>;
-            readonly foreignExempt: Schema.NullOr<Schema.Boolean>;
-            readonly people: Schema.$Array<Schema.Struct<{
-                readonly sourceName: Schema.String;
-                readonly displayName: Schema.String;
-                readonly title: Schema.String;
-                readonly sourceCategory: Schema.Literals<readonly ["directors", "secretaries"]>;
-            }>>;
-        }>;
-        readonly startedAt: Schema.String;
-        readonly observedAt: Schema.String;
-        readonly lastChangedAt: Schema.String;
-    }>;
-    readonly generation: Schema.String;
-    readonly enrichment: Schema.optionalKey<Schema.Struct<{
-        readonly ticker: Schema.String;
-        readonly sourceId: Schema.NonEmptyString;
-        readonly abn: Schema.String;
-        readonly acn: Schema.NullOr<Schema.String>;
-        readonly legalName: Schema.NonEmptyString;
-        readonly identityEvidence: Schema.Struct<{
-            readonly url: Schema.String;
-            readonly sha256: Schema.String;
-            readonly observedAt: Schema.String;
-            readonly kind: Schema.Literals<readonly ["issuer-filing", "issuer-website"]>;
-        }>;
-        readonly abrEvidence: Schema.Struct<{
-            readonly source: Schema.Literals<readonly ["abr-live", "abr-snapshot"]>;
-            readonly observedAt: Schema.String;
-        }>;
-        readonly website: Schema.NullOr<Schema.Struct<{
-            readonly url: Schema.String;
-            readonly evidence: Schema.Struct<{
-                readonly url: Schema.String;
-                readonly sha256: Schema.String;
-                readonly observedAt: Schema.String;
-                readonly kind: Schema.Literals<readonly ["issuer-filing", "issuer-website"]>;
-            }>;
-        }>>;
-    }>>;
-    readonly requiresRecheck: Schema.Literal<true>;
-    readonly fallbackReason: Schema.optionalKey<Schema.Literals<readonly ["INVALID_INPUT", "PARSE_FAILED", "SOURCE_MISMATCH", "TRANSPORT_FAILED", "TIMEOUT", "RATE_LIMITED", "UPSTREAM_UNAVAILABLE", "CONFIGURATION_ERROR", "SNAPSHOT_UNAVAILABLE", "CANCELLED", "INTERNAL_ERROR", "ACCESS_DENIED", "UPSTREAM_REJECTED", "PERSISTENCE_FAILED", "PUBLICATION_CONFLICT", "COVERAGE_REJECTED"]>>;
-}>, Schema.Struct<{
-    readonly status: Schema.Literal<"missing">;
-    readonly source: Schema.Literal<"snapshot">;
-    readonly generation: Schema.String;
-}>]>>, Schema.toCodecJson<Schema.Struct<{
-    readonly code: Schema.Literals<readonly [string, ...string[]]>;
-    readonly message: Schema.String;
-    readonly retryable: Schema.Boolean;
-    readonly requestId: Schema.String;
-}>>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"suggest", "POST", "/asx/v1/suggest", never, never, Schema.toCodecJson<Schema.Struct<{
-    readonly mode: Schema.optionalKey<Schema.Literals<readonly ["live", "snapshot", "live-first"]>>;
-    readonly query: Schema.String;
-    readonly limit: Schema.optionalKey<Schema.Number>;
-}>>, never, Schema.toCodecJson<Schema.Union<readonly [Schema.Struct<{
-    readonly source: Schema.Literal<"live">;
-    readonly directoryObservedAt: Schema.String;
-    readonly suggestions: Schema.$Array<Schema.Struct<{
-        readonly ticker: Schema.String;
-        readonly companyName: Schema.String;
-        readonly industryGroup: Schema.NullOr<Schema.String>;
-        readonly listingDate: Schema.NullOr<Schema.String>;
-        readonly marketCapitalisation: Schema.NullOr<Schema.Number>;
-    }>>;
-}>, Schema.Struct<{
-    readonly source: Schema.Literal<"snapshot">;
-    readonly generation: Schema.String;
-    readonly directoryObservedAt: Schema.String;
-    readonly requiresRecheck: Schema.Literal<true>;
-    readonly suggestions: Schema.$Array<Schema.Struct<{
-        readonly ticker: Schema.String;
-        readonly companyName: Schema.String;
-        readonly industryGroup: Schema.NullOr<Schema.String>;
-        readonly listingDate: Schema.NullOr<Schema.String>;
-        readonly marketCapitalisation: Schema.NullOr<Schema.Number>;
-    }>>;
-    readonly fallbackReason: Schema.optionalKey<Schema.Literals<readonly ["INVALID_INPUT", "PARSE_FAILED", "SOURCE_MISMATCH", "TRANSPORT_FAILED", "TIMEOUT", "RATE_LIMITED", "UPSTREAM_UNAVAILABLE", "CONFIGURATION_ERROR", "SNAPSHOT_UNAVAILABLE", "CANCELLED", "INTERNAL_ERROR", "ACCESS_DENIED", "UPSTREAM_REJECTED", "PERSISTENCE_FAILED", "PUBLICATION_CONFLICT", "COVERAGE_REJECTED"]>>;
-}>]>>, Schema.toCodecJson<Schema.Struct<{
-    readonly code: Schema.Literals<readonly [string, ...string[]]>;
-    readonly message: Schema.String;
-    readonly retryable: Schema.Boolean;
-    readonly requestId: Schema.String;
-}>>, never, never>, false>>;
-/** The OpenAPI document for the ASX contract. */
-export declare const asxOpenApiDocument: () => OpenApi.OpenAPISpec;

package/dist/contract/http-api.js

@@ -1,100 +0,0 @@
-import { Schema } from "effect";
-import { HttpApi, HttpApiEndpoint, HttpApiGroup, HttpApiSchema, OpenApi, } from "effect/unstable/httpapi";
-import { LookupResponse, SuggestionsResponse } from "../client-replies.js";
-import { AsxLookupRequestSchema, AsxSuggestRequestSchema } from "../requests.js";
-// The ASX HTTP contract (ADR-0052, platform #515 wave 3, T2), built from the package's own
-// request and reply schemas.
-const errorBody = (name, codes, status, description) => Schema.Struct({
-    code: Schema.Literals(codes),
-    message: Schema.String,
-    retryable: Schema.Boolean,
-    requestId: Schema.String.annotate({ description: "The request's id, for support." }),
-})
-    .annotate({ identifier: `AsxError_${name}`, description })
-    .pipe(HttpApiSchema.status(status));
-const ERRORS = [
-    errorBody("INVALID_INPUT", ["INVALID_INPUT"], 400, "The body is not valid for this operation."),
-    errorBody("UNAUTHORIZED", ["UNAUTHORIZED"], 401, "The request carries no identified caller (ADR-0018)."),
-    errorBody("VERSION_RETIRED", ["VERSION_RETIRED"], 410, "This major version is retired (ADR-0050)."),
-    errorBody("FAIR_USE_CEILING", ["FAIR_USE_CEILING"], 429, "The fair-use ceiling is reached; retry after Retry-After."),
-    errorBody("UPSTREAM", ["UPSTREAM_REJECTED", "PARSE_FAILED", "SOURCE_MISMATCH"], 502, "ASX answered, but its answer could not be used."),
-    errorBody("UNAVAILABLE", [
-        "TRANSPORT_FAILED",
-        "RATE_LIMITED",
-        "UPSTREAM_UNAVAILABLE",
-        "ACCESS_DENIED",
-        "CONFIGURATION_ERROR",
-        "SNAPSHOT_UNAVAILABLE",
-        "PERSISTENCE_FAILED",
-    ], 503, "The source is unavailable."),
-    errorBody("TIMEOUT", ["TIMEOUT"], 504, "The operation did not finish within its deadline."),
-];
-export const ASX_API_MAJOR = 1;
-export const ASX_API_PREFIX = `/asx/v${ASX_API_MAJOR}`;
-const naming = (method) => ({
-    "x-fern-sdk-group-name": "asx",
-    "x-fern-sdk-method-name": method,
-    "x-fern-availability": "beta",
-    "x-comms-id-safe-to-retry": true,
-    "x-comms-id-auth": { audience: "asx-lookup", scope: "asx" },
-});
-const LOOKUP_EXAMPLE = Schema.decodeUnknownSync(LookupResponse)({
-    status: "missing",
-    source: "live",
-    startedAt: "2026-10-03T00:00:00.000Z",
-    observedAt: "2026-10-03T00:00:01.000Z",
-});
-const SUGGEST_EXAMPLE = Schema.decodeUnknownSync(SuggestionsResponse)({
-    source: "live",
-    directoryObservedAt: "2026-10-03T00:00:00.000Z",
-    suggestions: [],
-});
-// Request examples, decoded once through their schemas so an invalid one fails at load.
-const exampleOf = (schema, value) => {
-    Schema.decodeUnknownSync(schema)(value);
-    return value;
-};
-const REQUEST_EXAMPLES = {
-    lookup: exampleOf(AsxLookupRequestSchema, { ticker: "BHP" }),
-    suggest: exampleOf(AsxSuggestRequestSchema, { query: "BH", limit: 5 }),
-};
-export const AsxApi = HttpApi.make("asx")
-    .add(HttpApiGroup.make("asx")
-    .add(HttpApiEndpoint.post("lookup", `${ASX_API_PREFIX}/lookup`, {
-    payload: AsxLookupRequestSchema,
-    success: LookupResponse.annotate({ examples: [LOOKUP_EXAMPLE] }),
-    error: ERRORS,
-})
-    .annotate(OpenApi.Description, "Look up an ASX-listed company by ticker, live or from the stored directory.")
-    .annotate(OpenApi.Override, naming("lookup")))
-    .add(HttpApiEndpoint.post("suggest", `${ASX_API_PREFIX}/suggest`, {
-    payload: AsxSuggestRequestSchema,
-    success: SuggestionsResponse.annotate({ examples: [SUGGEST_EXAMPLE] }),
-    error: ERRORS,
-})
-    .annotate(OpenApi.Description, "Suggest ASX-listed companies for a ticker or name prefix, at most ten.")
-    .annotate(OpenApi.Override, naming("suggest"))))
-    .annotate(OpenApi.Title, "Comms.ID ASX")
-    .annotate(OpenApi.Version, `${ASX_API_MAJOR}.0.0`)
-    // The Sydney front door (TLS terminates in Australia). Its pool routes /asx/* here and
-    // strips the prefix; the worker accepts /asx/v1/* and /v1/* alike.
-    .annotate(OpenApi.Servers, [
-    {
-        url: "https://o5tejx16gc.execute-api.ap-southeast-2.amazonaws.com",
-        description: "Sydney front door (TLS terminates in Australia)",
-    },
-])
-    // The request examples go in the named map of each request media type (the convention of
-    // every Comms.ID contract).
-    .annotate(OpenApi.Transform, (spec) => {
-    const { paths } = spec;
-    for (const [operation, value] of Object.entries(REQUEST_EXAMPLES)) {
-        const media = paths[`${ASX_API_PREFIX}/${operation}`]?.post?.requestBody?.content["application/json"];
-        if (media !== undefined) {
-            media.examples = { default: { value } };
-        }
-    }
-    return spec;
-});
-/** The OpenAPI document for the ASX contract. */
-export const asxOpenApiDocument = () => OpenApi.fromApi(AsxApi);

package/dist/profile-contact.d.ts

@@ -1,13 +0,0 @@
-import type { CompanySources, SourceName } from "./source-record.js";
-export interface ProfileContact {
-    readonly address: string | null;
-    readonly tel: string | null;
-    readonly website: string | null;
-    /** Which collected source supplied each value; absent when the value is null. */
-    readonly sources: Partial<Record<"address" | "tel" | "website", SourceName>>;
-}
-/**
- * Contact details from collected public profiles, used only where the ASX profile is blank.
- * Values are never inferred: each comes verbatim from one named source.
- */
-export declare function profileContact(sources: CompanySources): ProfileContact;

package/dist/profile-contact.js

@@ -1,66 +0,0 @@
-const PHONE = /^T\s+(\+?[\d\s()-]{6,})$/;
-const WEB = /^(https?:\/\/|www\.)/i;
-const AU_TAIL = /^(.+),\s*([^,]+?),?\s+(ACT|NSW|NT|QLD|SA|TAS|VIC|WA)\s+(\d{4})$/i;
-/** Morningstar writes "street, suburb, STATE 3000"; ASX's own field is "street, suburb, STATE, Australia, 3000". */
-const asxAddressFormat = (line) => {
-    const match = AU_TAIL.exec(line);
-    return match
-        ? `${match[1]}, ${match[2]}, ${match[3].toUpperCase()}, Australia, ${match[4]}`
-        : line;
-};
-const profileText = (payload, selector) => {
-    const response = payload?.response;
-    const match = response?.result?.find((entry) => entry.selector === selector);
-    return match?.results?.map((result) => result.text ?? "").join("\n") ?? "";
-};
-/** Morningstar's contact block: "Contact", the address line, "T <phone>", then the website. */
-const morningstarContact = (payload) => {
-    const lines = profileText(payload, ".sal-component-body:has(.sal-dp-pair-contact)")
-        .split("\n")
-        .map((line) => line.trim());
-    const start = lines.indexOf("Contact");
-    if (start < 0) {
-        return { address: null, tel: null };
-    }
-    let address = null;
-    let tel = null;
-    for (const line of lines.slice(start + 1, start + 5)) {
-        const phone = PHONE.exec(line);
-        if (phone?.[1]) {
-            tel = phone[1].trim();
-        }
-        else if (!(address || WEB.test(line)) && line.length > 5 && /\d/.test(line)) {
-            address = asxAddressFormat(line);
-        }
-    }
-    return { address, tel };
-};
-/**
- * Contact details from collected public profiles, used only where the ASX profile is blank.
- * Values are never inferred: each comes verbatim from one named source.
- */
-export function profileContact(sources) {
-    const found = (name) => sources[name]?.status === "found" ? sources[name] : undefined;
-    const morningstar = found("morningstar");
-    const google = found("google-finance");
-    const contact = morningstar
-        ? morningstarContact(morningstar.payload)
-        : { address: null, tel: null };
-    const website = morningstar?.websites[0] ?? google?.websites[0] ?? null;
-    return {
-        address: contact.address,
-        tel: contact.tel,
-        website,
-        sources: {
-            ...(contact.address ? { address: "morningstar" } : {}),
-            ...(contact.tel ? { tel: "morningstar" } : {}),
-            ...(website
-                ? {
-                    website: morningstar?.websites[0]
-                        ? "morningstar"
-                        : "google-finance",
-                }
-                : {}),
-        },
-    };
-}

package/dist/requests.d.ts

@@ -1,10 +0,0 @@
-import { Schema } from "effect";
-export declare const AsxLookupRequestSchema: Schema.Struct<{
-    readonly ticker: Schema.String;
-    readonly mode: Schema.optionalKey<Schema.Literals<readonly ["live", "snapshot", "live-first"]>>;
-}>;
-export declare const AsxSuggestRequestSchema: Schema.Struct<{
-    readonly mode: Schema.optionalKey<Schema.Literals<readonly ["live", "snapshot", "live-first"]>>;
-    readonly query: Schema.String;
-    readonly limit: Schema.optionalKey<Schema.Number>;
-}>;

package/dist/requests.js

@@ -1,21 +0,0 @@
-import { Schema } from "effect";
-// Request bodies for the hosted ASX service (platform #515): the worker decodes with these,
-// and the v1 contract is built from them.
-const Mode = Schema.Literals(["live", "snapshot", "live-first"]).annotate({
-    description: "live: ASX now; snapshot: the stored directory; live-first: ASX, then the snapshot on failure.",
-});
-export const AsxLookupRequestSchema = Schema.Struct({
-    ticker: Schema.String.check(Schema.isMaxLength(128)).annotate({
-        description: "The ASX ticker, for example 'BHP'.",
-    }),
-    mode: Schema.optionalKey(Mode),
-});
-export const AsxSuggestRequestSchema = Schema.Struct({
-    mode: Schema.optionalKey(Mode),
-    query: Schema.String.check(Schema.isMaxLength(200)).annotate({
-        description: "A ticker or company name prefix.",
-    }),
-    limit: Schema.optionalKey(Schema.Number.check(Schema.isInt(), Schema.isBetween({ minimum: 1, maximum: 10 })).annotate({
-        description: "How many suggestions to return, 1 to 10.",
-    })),
-});