@loams/client 0.0.0-stage → 0.1.0

package/dist/gen/facade.js

@@ -0,0 +1,441 @@
+// @generated by protoc-gen-loams-facade from proto/. Do not edit.
+//
+// The SDK facade of design §44 §7.3: one typed interface per service
+// annotated with `loams.options.v1.module`, one method per
+// `loams.options.v1.facade` call, and the binding table the hand-written
+// runtime dispatches through. Regenerate with `pnpm --filter @loams/client
+// generate`; the drift check in CI fails if this file is stale.
+/* eslint-disable */
+/**
+*  The proto revision this SDK was generated from (`LOAMS_PROTO_REV`,
+*  design §44 §10.3). `loams.system.version()` checks it against the
+*  server's `GetInstance.api_versions`.
+*/
+export const PROTO_REV = 'v1';
+import { AgentService, AuditService, KeyService, OrgService, ProjectService } from '../vendor/proto/admin.js';
+import { AuthService } from '../vendor/proto/gen/loams/auth/v1/auth_pb.js';
+import { InstanceService } from '../vendor/proto/gen/loams/instance/v1/instance_pb.js';
+import { LiveAdminService, LiveService } from '@loams/live/live';
+/** Every annotated service, as the module catalogue. Order is by module name. */
+export const MODULES = [
+    {
+        name: 'admin.agents',
+        summary: 'Agents, their tokens and trust policies, and service accounts.',
+        service: 'loams.admin.v1.AgentService',
+        package: 'loams.admin.v1',
+        unstable: false,
+        derived: false,
+        calls: [
+            { module: 'admin.agents', name: 'create', protoName: 'create', method: 'CreateAgent', rpc: 'loams.admin.v1.AgentService/CreateAgent', service: 'loams.admin.v1.AgentService', package: 'loams.admin.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'admin.agents', name: 'createServiceAccount', protoName: 'createServiceAccount', method: 'CreateServiceAccount', rpc: 'loams.admin.v1.AgentService/CreateServiceAccount', service: 'loams.admin.v1.AgentService', package: 'loams.admin.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'admin.agents', name: 'createTrustPolicy', protoName: 'createTrustPolicy', method: 'CreateTrustPolicy', rpc: 'loams.admin.v1.AgentService/CreateTrustPolicy', service: 'loams.admin.v1.AgentService', package: 'loams.admin.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'admin.agents', name: 'get', protoName: 'get', method: 'GetAgent', rpc: 'loams.admin.v1.AgentService/GetAgent', service: 'loams.admin.v1.AgentService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'admin.agents', name: 'list', protoName: 'list', method: 'ListAgents', rpc: 'loams.admin.v1.AgentService/ListAgents', service: 'loams.admin.v1.AgentService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: { items: 'agents', nextPageToken: 'nextPageToken' } },
+            { module: 'admin.agents', name: 'listServiceAccounts', protoName: 'listServiceAccounts', method: 'ListServiceAccounts', rpc: 'loams.admin.v1.AgentService/ListServiceAccounts', service: 'loams.admin.v1.AgentService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: { items: 'service_accounts', nextPageToken: 'nextPageToken' } },
+            { module: 'admin.agents', name: 'listTokens', protoName: 'listTokens', method: 'ListAgentTokens', rpc: 'loams.admin.v1.AgentService/ListAgentTokens', service: 'loams.admin.v1.AgentService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: { items: 'tokens', nextPageToken: 'nextPageToken' } },
+            { module: 'admin.agents', name: 'listTrustPolicies', protoName: 'listTrustPolicies', method: 'ListTrustPolicies', rpc: 'loams.admin.v1.AgentService/ListTrustPolicies', service: 'loams.admin.v1.AgentService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: { items: 'trust_policies', nextPageToken: 'nextPageToken' } },
+            { module: 'admin.agents', name: 'resume', protoName: 'resume', method: 'ResumeAgent', rpc: 'loams.admin.v1.AgentService/ResumeAgent', service: 'loams.admin.v1.AgentService', package: 'loams.admin.v1', idempotency: 'idempotent', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'admin.agents', name: 'suspend', protoName: 'suspend', method: 'SuspendAgent', rpc: 'loams.admin.v1.AgentService/SuspendAgent', service: 'loams.admin.v1.AgentService', package: 'loams.admin.v1', idempotency: 'idempotent', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'admin.agents', name: 'update', protoName: 'update', method: 'UpdateAgent', rpc: 'loams.admin.v1.AgentService/UpdateAgent', service: 'loams.admin.v1.AgentService', package: 'loams.admin.v1', idempotency: 'idempotent', retry: 'safe', streaming: 'unary', pagination: null },
+        ],
+    },
+    {
+        name: 'admin.audit',
+        summary: 'The audit log: who did what, to what, and whether it was allowed.',
+        service: 'loams.admin.v1.AuditService',
+        package: 'loams.admin.v1',
+        unstable: false,
+        derived: false,
+        calls: [
+            { module: 'admin.audit', name: 'list', protoName: 'list', method: 'ListAuditEvents', rpc: 'loams.admin.v1.AuditService/ListAuditEvents', service: 'loams.admin.v1.AuditService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: { items: 'events', nextPageToken: 'nextPageToken' } },
+            { module: 'admin.audit', name: 'watch', protoName: 'watch', method: 'WatchAuditEvents', rpc: 'loams.admin.v1.AuditService/WatchAuditEvents', service: 'loams.admin.v1.AuditService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'server', pagination: null },
+        ],
+    },
+    {
+        name: 'admin.keys',
+        summary: 'API keys, and revoking agent tokens.',
+        service: 'loams.admin.v1.KeyService',
+        package: 'loams.admin.v1',
+        unstable: false,
+        derived: false,
+        calls: [
+            { module: 'admin.keys', name: 'create', protoName: 'create', method: 'CreateKey', rpc: 'loams.admin.v1.KeyService/CreateKey', service: 'loams.admin.v1.KeyService', package: 'loams.admin.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'admin.keys', name: 'list', protoName: 'list', method: 'ListKeys', rpc: 'loams.admin.v1.KeyService/ListKeys', service: 'loams.admin.v1.KeyService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: { items: 'keys', nextPageToken: 'nextPageToken' } },
+            { module: 'admin.keys', name: 'revoke', protoName: 'revoke', method: 'RevokeKey', rpc: 'loams.admin.v1.KeyService/RevokeKey', service: 'loams.admin.v1.KeyService', package: 'loams.admin.v1', idempotency: 'idempotent', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'admin.keys', name: 'revokeToken', protoName: 'revokeToken', method: 'RevokeToken', rpc: 'loams.admin.v1.KeyService/RevokeToken', service: 'loams.admin.v1.KeyService', package: 'loams.admin.v1', idempotency: 'idempotent', retry: 'safe', streaming: 'unary', pagination: null },
+        ],
+    },
+    {
+        name: 'admin.org',
+        summary: 'The org: settings, members, invitations and teams.',
+        service: 'loams.admin.v1.OrgService',
+        package: 'loams.admin.v1',
+        unstable: false,
+        derived: false,
+        calls: [
+            { module: 'admin.org', name: 'addTeamMember', protoName: 'addTeamMember', method: 'AddTeamMember', rpc: 'loams.admin.v1.OrgService/AddTeamMember', service: 'loams.admin.v1.OrgService', package: 'loams.admin.v1', idempotency: 'idempotent', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'admin.org', name: 'createInvitation', protoName: 'createInvitation', method: 'CreateInvitation', rpc: 'loams.admin.v1.OrgService/CreateInvitation', service: 'loams.admin.v1.OrgService', package: 'loams.admin.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'admin.org', name: 'createTeam', protoName: 'createTeam', method: 'CreateTeam', rpc: 'loams.admin.v1.OrgService/CreateTeam', service: 'loams.admin.v1.OrgService', package: 'loams.admin.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'admin.org', name: 'get', protoName: 'get', method: 'GetOrg', rpc: 'loams.admin.v1.OrgService/GetOrg', service: 'loams.admin.v1.OrgService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'admin.org', name: 'getTeam', protoName: 'getTeam', method: 'GetTeam', rpc: 'loams.admin.v1.OrgService/GetTeam', service: 'loams.admin.v1.OrgService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'admin.org', name: 'listInvitations', protoName: 'listInvitations', method: 'ListInvitations', rpc: 'loams.admin.v1.OrgService/ListInvitations', service: 'loams.admin.v1.OrgService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: { items: 'invitations', nextPageToken: 'nextPageToken' } },
+            { module: 'admin.org', name: 'listMembers', protoName: 'listMembers', method: 'ListMembers', rpc: 'loams.admin.v1.OrgService/ListMembers', service: 'loams.admin.v1.OrgService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: { items: 'members', nextPageToken: 'nextPageToken' } },
+            { module: 'admin.org', name: 'listTeams', protoName: 'listTeams', method: 'ListTeams', rpc: 'loams.admin.v1.OrgService/ListTeams', service: 'loams.admin.v1.OrgService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: { items: 'teams', nextPageToken: 'nextPageToken' } },
+            { module: 'admin.org', name: 'removeMember', protoName: 'removeMember', method: 'RemoveMember', rpc: 'loams.admin.v1.OrgService/RemoveMember', service: 'loams.admin.v1.OrgService', package: 'loams.admin.v1', idempotency: 'idempotent', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'admin.org', name: 'update', protoName: 'update', method: 'UpdateOrg', rpc: 'loams.admin.v1.OrgService/UpdateOrg', service: 'loams.admin.v1.OrgService', package: 'loams.admin.v1', idempotency: 'idempotent', retry: 'safe', streaming: 'unary', pagination: null },
+        ],
+    },
+    {
+        name: 'admin.projects',
+        summary: 'Projects, project access and environments.',
+        service: 'loams.admin.v1.ProjectService',
+        package: 'loams.admin.v1',
+        unstable: false,
+        derived: false,
+        calls: [
+            { module: 'admin.projects', name: 'create', protoName: 'create', method: 'CreateProject', rpc: 'loams.admin.v1.ProjectService/CreateProject', service: 'loams.admin.v1.ProjectService', package: 'loams.admin.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'admin.projects', name: 'createEnvironment', protoName: 'createEnvironment', method: 'CreateEnvironment', rpc: 'loams.admin.v1.ProjectService/CreateEnvironment', service: 'loams.admin.v1.ProjectService', package: 'loams.admin.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'admin.projects', name: 'get', protoName: 'get', method: 'GetProject', rpc: 'loams.admin.v1.ProjectService/GetProject', service: 'loams.admin.v1.ProjectService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'admin.projects', name: 'getEnvironment', protoName: 'getEnvironment', method: 'GetEnvironment', rpc: 'loams.admin.v1.ProjectService/GetEnvironment', service: 'loams.admin.v1.ProjectService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'admin.projects', name: 'getEnvironmentActivity', protoName: 'getEnvironmentActivity', method: 'GetEnvironmentActivity', rpc: 'loams.admin.v1.ProjectService/GetEnvironmentActivity', service: 'loams.admin.v1.ProjectService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'admin.projects', name: 'grantAccess', protoName: 'grantAccess', method: 'GrantAccess', rpc: 'loams.admin.v1.ProjectService/GrantAccess', service: 'loams.admin.v1.ProjectService', package: 'loams.admin.v1', idempotency: 'idempotent', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'admin.projects', name: 'list', protoName: 'list', method: 'ListProjects', rpc: 'loams.admin.v1.ProjectService/ListProjects', service: 'loams.admin.v1.ProjectService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: { items: 'projects', nextPageToken: 'nextPageToken' } },
+            { module: 'admin.projects', name: 'listAccess', protoName: 'listAccess', method: 'ListAccess', rpc: 'loams.admin.v1.ProjectService/ListAccess', service: 'loams.admin.v1.ProjectService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: { items: 'grants', nextPageToken: 'nextPageToken' } },
+            { module: 'admin.projects', name: 'listEnvironments', protoName: 'listEnvironments', method: 'ListEnvironments', rpc: 'loams.admin.v1.ProjectService/ListEnvironments', service: 'loams.admin.v1.ProjectService', package: 'loams.admin.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: { items: 'environments', nextPageToken: 'nextPageToken' } },
+        ],
+    },
+    {
+        name: 'auth',
+        summary: 'Sign-in providers, first-run setup, sessions and OAuth consent.',
+        service: 'loams.auth.v1.AuthService',
+        package: 'loams.auth.v1',
+        unstable: false,
+        derived: false,
+        calls: [
+            { module: 'auth', name: 'completeSetup', protoName: 'completeSetup', method: 'CompleteSetup', rpc: 'loams.auth.v1.AuthService/CompleteSetup', service: 'loams.auth.v1.AuthService', package: 'loams.auth.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'auth', name: 'createSession', protoName: 'createSession', method: 'CreateSession', rpc: 'loams.auth.v1.AuthService/CreateSession', service: 'loams.auth.v1.AuthService', package: 'loams.auth.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'auth', name: 'decideConsent', protoName: 'decideConsent', method: 'DecideConsent', rpc: 'loams.auth.v1.AuthService/DecideConsent', service: 'loams.auth.v1.AuthService', package: 'loams.auth.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'auth', name: 'deleteSession', protoName: 'deleteSession', method: 'DeleteSession', rpc: 'loams.auth.v1.AuthService/DeleteSession', service: 'loams.auth.v1.AuthService', package: 'loams.auth.v1', idempotency: 'idempotent', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'auth', name: 'getSession', protoName: 'getSession', method: 'GetSession', rpc: 'loams.auth.v1.AuthService/GetSession', service: 'loams.auth.v1.AuthService', package: 'loams.auth.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'auth', name: 'listProviders', protoName: 'listProviders', method: 'ListProviders', rpc: 'loams.auth.v1.AuthService/ListProviders', service: 'loams.auth.v1.AuthService', package: 'loams.auth.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: null },
+        ],
+    },
+    {
+        name: 'instance',
+        summary: 'What this instance is, and who the caller is on it.',
+        service: 'loams.instance.v1.InstanceService',
+        package: 'loams.instance.v1',
+        unstable: false,
+        derived: false,
+        calls: [
+            { module: 'instance', name: 'getInstance', protoName: 'getInstance', method: 'GetInstance', rpc: 'loams.instance.v1.InstanceService/GetInstance', service: 'loams.instance.v1.InstanceService', package: 'loams.instance.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'instance', name: 'whoAmI', protoName: 'whoAmI', method: 'WhoAmI', rpc: 'loams.instance.v1.InstanceService/WhoAmI', service: 'loams.instance.v1.InstanceService', package: 'loams.instance.v1', idempotency: 'no_side_effects', retry: 'safe', streaming: 'unary', pagination: null },
+        ],
+    },
+    {
+        name: 'live',
+        summary: 'Live sync: watch a query set over a server stream.',
+        service: 'loams.live.v1.LiveService',
+        package: 'loams.live.v1',
+        unstable: true,
+        derived: false,
+        calls: [
+            { module: 'live', name: 'authenticate', protoName: 'authenticate', method: 'Authenticate', rpc: 'loams.live.v1.LiveService/Authenticate', service: 'loams.live.v1.LiveService', package: 'loams.live.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'live', name: 'modifyQuerySet', protoName: 'modifyQuerySet', method: 'ModifyQuerySet', rpc: 'loams.live.v1.LiveService/ModifyQuerySet', service: 'loams.live.v1.LiveService', package: 'loams.live.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'live', name: 'watch', protoName: 'watch', method: 'Watch', rpc: 'loams.live.v1.LiveService/Watch', service: 'loams.live.v1.LiveService', package: 'loams.live.v1', idempotency: 'none', retry: 'manual', streaming: 'server', pagination: null },
+        ],
+    },
+    {
+        name: 'live.admin',
+        summary: 'Live administration: apps, deploy, roll back, index status and function logs.',
+        service: 'loams.live.v1.LiveAdminService',
+        package: 'loams.live.v1',
+        unstable: true,
+        derived: false,
+        calls: [
+            { module: 'live.admin', name: 'activateDeployment', protoName: 'activateDeployment', method: 'ActivateDeployment', rpc: 'loams.live.v1.LiveAdminService/ActivateDeployment', service: 'loams.live.v1.LiveAdminService', package: 'loams.live.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'live.admin', name: 'createApp', protoName: 'createApp', method: 'CreateApp', rpc: 'loams.live.v1.LiveAdminService/CreateApp', service: 'loams.live.v1.LiveAdminService', package: 'loams.live.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'live.admin', name: 'deleteApp', protoName: 'deleteApp', method: 'DeleteApp', rpc: 'loams.live.v1.LiveAdminService/DeleteApp', service: 'loams.live.v1.LiveAdminService', package: 'loams.live.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'live.admin', name: 'deploy', protoName: 'deploy', method: 'Deploy', rpc: 'loams.live.v1.LiveAdminService/Deploy', service: 'loams.live.v1.LiveAdminService', package: 'loams.live.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'live.admin', name: 'getApp', protoName: 'getApp', method: 'GetApp', rpc: 'loams.live.v1.LiveAdminService/GetApp', service: 'loams.live.v1.LiveAdminService', package: 'loams.live.v1', idempotency: 'none', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'live.admin', name: 'getDeployment', protoName: 'getDeployment', method: 'GetDeployment', rpc: 'loams.live.v1.LiveAdminService/GetDeployment', service: 'loams.live.v1.LiveAdminService', package: 'loams.live.v1', idempotency: 'none', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'live.admin', name: 'getIndexStatus', protoName: 'getIndexStatus', method: 'GetIndexStatus', rpc: 'loams.live.v1.LiveAdminService/GetIndexStatus', service: 'loams.live.v1.LiveAdminService', package: 'loams.live.v1', idempotency: 'none', retry: 'safe', streaming: 'unary', pagination: null },
+            { module: 'live.admin', name: 'listApps', protoName: 'listApps', method: 'ListApps', rpc: 'loams.live.v1.LiveAdminService/ListApps', service: 'loams.live.v1.LiveAdminService', package: 'loams.live.v1', idempotency: 'none', retry: 'safe', streaming: 'unary', pagination: { items: 'apps', nextPageToken: 'nextPageToken' } },
+            { module: 'live.admin', name: 'listDeployments', protoName: 'listDeployments', method: 'ListDeployments', rpc: 'loams.live.v1.LiveAdminService/ListDeployments', service: 'loams.live.v1.LiveAdminService', package: 'loams.live.v1', idempotency: 'none', retry: 'safe', streaming: 'unary', pagination: { items: 'deployments', nextPageToken: 'nextPageToken' } },
+            { module: 'live.admin', name: 'tailLogs', protoName: 'tailLogs', method: 'TailLogs', rpc: 'loams.live.v1.LiveAdminService/TailLogs', service: 'loams.live.v1.LiveAdminService', package: 'loams.live.v1', idempotency: 'none', retry: 'manual', streaming: 'server', pagination: null },
+            { module: 'live.admin', name: 'updateApp', protoName: 'updateApp', method: 'UpdateApp', rpc: 'loams.live.v1.LiveAdminService/UpdateApp', service: 'loams.live.v1.LiveAdminService', package: 'loams.live.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+        ],
+    },
+    {
+        name: 'tables',
+        summary: '',
+        service: 'loams.live.v1.LiveService',
+        package: 'loams.live.v1',
+        unstable: true,
+        derived: true,
+        calls: [
+            { module: 'tables', name: 'mutate', protoName: 'mutate', method: 'Mutate', rpc: 'loams.live.v1.LiveService/Mutate', service: 'loams.live.v1.LiveService', package: 'loams.live.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+            { module: 'tables', name: 'query', protoName: 'query', method: 'Query', rpc: 'loams.live.v1.LiveService/Query', service: 'loams.live.v1.LiveService', package: 'loams.live.v1', idempotency: 'none', retry: 'manual', streaming: 'unary', pagination: null },
+        ],
+    },
+];
+/**
+*  The generated service descriptors, by fully qualified name. The runtime
+*  turns each into a Connect client with `createClient`, so a module is
+*  backed by the stubs `protoc-gen-es` wrote from the same protos rather
+*  than by a hand-written client.
+*/
+export const SERVICE_DESCRIPTORS = {
+    'loams.admin.v1.AgentService': AgentService,
+    'loams.admin.v1.AuditService': AuditService,
+    'loams.admin.v1.KeyService': KeyService,
+    'loams.admin.v1.OrgService': OrgService,
+    'loams.admin.v1.ProjectService': ProjectService,
+    'loams.auth.v1.AuthService': AuthService,
+    'loams.instance.v1.InstanceService': InstanceService,
+    'loams.live.v1.LiveAdminService': LiveAdminService,
+    'loams.live.v1.LiveService': LiveService,
+};
+/** The proto packages this SDK speaks, as `GetInstance.api_versions` names them. */
+export const PROTO_PACKAGES = [
+    'google.protobuf',
+    'loams.admin.v1',
+    'loams.approvals.v1',
+    'loams.auth.v1',
+    'loams.collection.v1',
+    'loams.devices.v1',
+    'loams.errors.v1',
+    'loams.graph.v1',
+    'loams.house.v1',
+    'loams.instance.v1',
+    'loams.live.v1',
+    'loams.live.worker.v1',
+    'loams.notifications.v1',
+    'loams.operations.v1',
+    'loams.options.v1',
+    'loams.postgres.v1',
+    'loams.repos.v1',
+];
+/**
+*  Every `reason` in `docs/api/reasons.md` (design §44 §7.4, D611). Within
+*  an API major version a reason is never renamed and never removed, so
+*  this union only grows; a caller switching on it is exhaustive.
+*/
+export const REASONS = [
+    'approval_expired',
+    'approval_already_decided',
+    'approval_stale_revision',
+    'requester_cannot_approve',
+    'decision_proof_invalid',
+    'step_up_required',
+    'reason_required',
+    'invalid_decision',
+    'pairing_expired',
+    'pairing_used',
+    'device_revoked',
+    'push_target_unknown',
+    'not_implemented',
+    'feature_not_in_variant',
+    'house_not_configured',
+    'house_syntax_error',
+    'house_unknown_table',
+    'house_unknown_database',
+    'house_access_denied',
+    'house_read_only',
+    'house_timeout',
+    'house_memory_limit',
+    'house_too_many_queries',
+    'house_quota_exceeded',
+    'house_disabled_function',
+    'house_cancelled',
+    'house_query_not_found',
+    'house_query_failed',
+    'project_not_found',
+    'branch_has_children',
+    'branch_protected',
+    'lsn_out_of_retention',
+    'endpoint_exists_for_branch',
+    'compute_start_failed',
+    'quota_exceeded',
+    'storage_unavailable',
+    'secret_already_issued',
+    'repo_not_found',
+    'repo_already_exists',
+    'repo_deleting',
+    'ref_stale',
+    'ref_protected',
+    'out_of_scope',
+    'object_format_unsupported',
+    'fork_too_deep',
+    'sequencer_unavailable',
+    'idempotency_key_reused',
+    'workspace_not_found',
+    'workspace_fenced',
+    'workspace_read_only',
+    'workspace_name_taken',
+    'object_missing',
+    'secret_detected',
+    'env_unsealed',
+    'env_access_denied',
+    'env_foreign_reference',
+    'live_bad_cursor',
+    'live_worker_crashed',
+    'live_deploy_conflict',
+    'live_schema_violation',
+    'live_index_not_ready',
+    'live_app_disabled',
+    'live_app_exists',
+    'live_function_error',
+    'live_function_timeout',
+    'live_function_out_of_memory',
+    'live_limit_exceeded',
+    'live_app_mismatch',
+    'live_origin_not_allowed',
+    'session_rotate',
+    'session_gone',
+    'node_draining',
+    'role_required',
+    'setup_required',
+    'token_missing',
+    'token_malformed',
+    'token_revoked',
+    'token_not_yet_valid',
+    'token_bad_signature',
+    'token_wrong_audience',
+    'token_wrong_issuer',
+    'token_unknown_key',
+    'token_algorithm_not_allowed',
+    'api_key_invalid',
+    'credential_not_accepted',
+    'credential_in_query_string',
+    'csrf_token_invalid',
+    'principal_not_allowed',
+    'cors_origin_not_allowed',
+    'auth_unavailable',
+    'invalid_argument',
+    'not_found',
+    'already_exists',
+    'permission_denied',
+    'token_expired',
+    'unauthenticated',
+    'failed_precondition',
+    'resource_exhausted',
+    'unavailable',
+    'deadline_exceeded',
+    'aborted',
+    'internal',
+];
+/** The Connect code each reason is raised under, from the same registry. */
+export const REASON_CODES = {
+    approval_expired: 'failed_precondition',
+    approval_already_decided: 'failed_precondition',
+    approval_stale_revision: 'failed_precondition',
+    requester_cannot_approve: 'permission_denied',
+    decision_proof_invalid: 'permission_denied',
+    step_up_required: 'unauthenticated',
+    reason_required: 'invalid_argument',
+    invalid_decision: 'invalid_argument',
+    pairing_expired: 'failed_precondition',
+    pairing_used: 'failed_precondition',
+    device_revoked: 'unauthenticated',
+    push_target_unknown: 'not_found',
+    not_implemented: 'unimplemented',
+    feature_not_in_variant: 'unimplemented',
+    house_not_configured: 'unimplemented',
+    house_syntax_error: 'invalid_argument',
+    house_unknown_table: 'not_found',
+    house_unknown_database: 'not_found',
+    house_access_denied: 'permission_denied',
+    house_read_only: 'failed_precondition',
+    house_timeout: 'deadline_exceeded',
+    house_memory_limit: 'resource_exhausted',
+    house_too_many_queries: 'resource_exhausted',
+    house_quota_exceeded: 'resource_exhausted',
+    house_disabled_function: 'permission_denied',
+    house_cancelled: 'canceled',
+    house_query_not_found: 'not_found',
+    house_query_failed: 'unknown',
+    project_not_found: 'not_found',
+    branch_has_children: 'failed_precondition',
+    branch_protected: 'failed_precondition',
+    lsn_out_of_retention: 'failed_precondition',
+    endpoint_exists_for_branch: 'already_exists',
+    compute_start_failed: 'unavailable',
+    quota_exceeded: 'resource_exhausted',
+    storage_unavailable: 'unavailable',
+    secret_already_issued: 'failed_precondition',
+    repo_not_found: 'not_found',
+    repo_already_exists: 'already_exists',
+    repo_deleting: 'failed_precondition',
+    ref_stale: 'aborted',
+    ref_protected: 'failed_precondition',
+    out_of_scope: 'permission_denied',
+    object_format_unsupported: 'unimplemented',
+    fork_too_deep: 'failed_precondition',
+    sequencer_unavailable: 'unavailable',
+    idempotency_key_reused: 'failed_precondition',
+    workspace_not_found: 'not_found',
+    workspace_fenced: 'aborted',
+    workspace_read_only: 'failed_precondition',
+    workspace_name_taken: 'already_exists',
+    object_missing: 'failed_precondition',
+    secret_detected: 'failed_precondition',
+    env_unsealed: 'invalid_argument',
+    env_access_denied: 'permission_denied',
+    env_foreign_reference: 'permission_denied',
+    live_bad_cursor: 'invalid_argument',
+    live_worker_crashed: 'internal',
+    live_deploy_conflict: 'failed_precondition',
+    live_schema_violation: 'invalid_argument',
+    live_index_not_ready: 'failed_precondition',
+    live_app_disabled: 'failed_precondition',
+    live_app_exists: 'failed_precondition',
+    live_function_error: 'unknown',
+    live_function_timeout: 'deadline_exceeded',
+    live_function_out_of_memory: 'resource_exhausted',
+    live_limit_exceeded: 'resource_exhausted',
+    live_app_mismatch: 'permission_denied',
+    live_origin_not_allowed: 'permission_denied',
+    session_rotate: 'unavailable',
+    session_gone: 'not_found',
+    node_draining: 'unavailable',
+    role_required: 'permission_denied',
+    setup_required: 'failed_precondition',
+    token_missing: 'unauthenticated',
+    token_malformed: 'unauthenticated',
+    token_revoked: 'unauthenticated',
+    token_not_yet_valid: 'unauthenticated',
+    token_bad_signature: 'unauthenticated',
+    token_wrong_audience: 'unauthenticated',
+    token_wrong_issuer: 'unauthenticated',
+    token_unknown_key: 'unauthenticated',
+    token_algorithm_not_allowed: 'unauthenticated',
+    api_key_invalid: 'unauthenticated',
+    credential_not_accepted: 'unauthenticated',
+    credential_in_query_string: 'unauthenticated',
+    csrf_token_invalid: 'permission_denied',
+    principal_not_allowed: 'permission_denied',
+    cors_origin_not_allowed: 'permission_denied',
+    auth_unavailable: 'unavailable',
+    invalid_argument: 'invalid_argument',
+    not_found: 'not_found',
+    already_exists: 'already_exists',
+    permission_denied: 'permission_denied',
+    token_expired: 'unauthenticated',
+    unauthenticated: 'unauthenticated',
+    failed_precondition: 'failed_precondition',
+    resource_exhausted: 'resource_exhausted',
+    unavailable: 'unavailable',
+    deadline_exceeded: 'deadline_exceeded',
+    aborted: 'aborted',
+    internal: 'internal',
+};
+/**
+*  The reason a package the build variant does not carry answers with
+*  (design §44 §4, D600). Every RPC of such a package refuses with it and
+*  names the variant in `metadata.variant`; the runtime turns that refusal
+*  into `FeatureNotInVariantError` so a caller can branch on it without
+*  calling first — `loams.system.available()` answers the same question from
+*  `GetInstance.services[]` without a failing call at all.
+*/
+export const FEATURE_NOT_IN_VARIANT = 'feature_not_in_variant';

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { Loams, type AdminNamespace, type LiveNamespace, type LoamsModules, type LoamsOptions, } from './loams.js';
+export { SystemApi, type Catalogue, type SystemConfig, type VersionReport, } from './system.js';
+export { FEATURE_NOT_IN_VARIANT, MODULES, PROTO_PACKAGES, PROTO_REV, REASON_CODES, REASONS, SERVICE_DESCRIPTORS, type CallBinding, type InstanceModule, type LiveModule, type ModuleBinding, type Reason, type TablesModule, } from './gen/facade.js';
+export { CallInvoker, callWithRetry, withIdempotencyKey, type Attempt, type CallOptions, type ConsistencyOptions, type ConsistencyTokenStore, type RetryPlan, type Send, } from './runtime/call.js';
+export { ConsistencySession, TOKEN_PREFIX, isConsistencyToken } from './runtime/consistency.js';
+export { AlreadyExistsError, AbortedError, DeadlineExceededError, FailedPreconditionError, FeatureNotInVariantError, InternalError, InvalidArgumentError, LoamsError, NotFoundError, PermissionDeniedError, ResourceExhaustedError, TokenExpiredError, UnauthenticatedError, UnavailableError, UnimplementedError, errorInfo, isLoamsError, toLoamsError, type ErrorInfoShape, } from './runtime/errors.js';
+export { paginate, pageFields, type PageFetcher, type PageRequestOptions } from './runtime/pagination.js';
+export { BASE_DELAY_MS, DEFAULT_MAX_RETRIES, MAX_DELAY_MS, MAX_SERVER_DELAY_MS, backoffMs, isRetryableCode, shouldRetry, sleep, } from './runtime/retry.js';
+export { watch, type CursorOf, type ResumeOptions, type StreamOpener } from './runtime/streams.js';
+export { apiKey, envToken, oidcExchange, refreshing, staticToken, type TokenSource, } from './runtime/token-source.js';
+export { createLoamsTransport, headersInterceptor, type TransportOptions, } from './runtime/transports.js';
+export { uuidv7, uuidv7Time } from './runtime/uuidv7.js';

package/dist/index.js

@@ -0,0 +1,32 @@
+// @loams/client: the Loams SDK for TypeScript and JavaScript.
+//
+//   import { Loams, apiKey } from '@loams/client';
+//
+//   const loams = new Loams({ endpoint: 'https://acme.loams.dev', auth: apiKey(key) });
+//   const info = await loams.instance.getInstance({});
+//   await loams.system.guard('live');            // no RPC once cached
+//   for await (const t of loams.live.watch(request, { resume })) {}
+//
+// Design §44 §7: one client object with namespaced modules, generated from the
+// `loams.options.v1` annotations on the protos, over the unified Connect API
+// on one port. `@loams/client/node` adds the HTTP/2 gRPC transport.
+//
+// What a caller imports from here: the `Loams` client, the module types the
+// generator produced, the typed error hierarchy, the token sources, and the
+// reason registry as a type.
+export { Loams, } from './loams.js';
+export { SystemApi, } from './system.js';
+// The generated facade: the module interfaces, the binding table, the proto
+// revision, and the reason registry as a type. Everything here is written by
+// `buf generate`; do not hand-edit it.
+export { FEATURE_NOT_IN_VARIANT, MODULES, PROTO_PACKAGES, PROTO_REV, REASON_CODES, REASONS, SERVICE_DESCRIPTORS, } from './gen/facade.js';
+// The runtime, for a caller who composes rather than uses.
+export { CallInvoker, callWithRetry, withIdempotencyKey, } from './runtime/call.js';
+export { ConsistencySession, TOKEN_PREFIX, isConsistencyToken } from './runtime/consistency.js';
+export { AlreadyExistsError, AbortedError, DeadlineExceededError, FailedPreconditionError, FeatureNotInVariantError, InternalError, InvalidArgumentError, LoamsError, NotFoundError, PermissionDeniedError, ResourceExhaustedError, TokenExpiredError, UnauthenticatedError, UnavailableError, UnimplementedError, errorInfo, isLoamsError, toLoamsError, } from './runtime/errors.js';
+export { paginate, pageFields } from './runtime/pagination.js';
+export { BASE_DELAY_MS, DEFAULT_MAX_RETRIES, MAX_DELAY_MS, MAX_SERVER_DELAY_MS, backoffMs, isRetryableCode, shouldRetry, sleep, } from './runtime/retry.js';
+export { watch } from './runtime/streams.js';
+export { apiKey, envToken, oidcExchange, refreshing, staticToken, } from './runtime/token-source.js';
+export { createLoamsTransport, headersInterceptor, } from './runtime/transports.js';
+export { uuidv7, uuidv7Time } from './runtime/uuidv7.js';

package/dist/loams.d.ts

@@ -0,0 +1,110 @@
+import type { Transport } from '@connectrpc/connect';
+import { type AdminAgentsModule, type AdminAuditModule, type AdminKeysModule, type AdminOrgModule, type AdminProjectsModule, type AuthModule, type CallBinding, type InstanceModule, type LiveAdminModule, type LiveModule, type ModuleBinding, type TablesModule } from './gen/facade.js';
+import { type CallOptions, type ConsistencyTokenStore } from './runtime/call.js';
+import { type PageRequestOptions } from './runtime/pagination.js';
+import { SystemApi } from './system.js';
+import { type TokenSource } from './runtime/token-source.js';
+import { type TransportOptions } from './runtime/transports.js';
+import { type ResumeOptions } from './runtime/streams.js';
+/** How to build a `Loams`. */
+export interface LoamsOptions {
+    /** The instance's base URL, for example `https://acme.loams.dev`. A
+     * loopback stack is `http://127.0.0.1:8080`. */
+    endpoint: string;
+    /**
+     * The bearer source. A string is taken as an API key, which is what a
+     * script or a CI job has; pass `envToken()` or `oidcExchange()` for the
+     * rest. Omitted means an unauthenticated client, which is what
+     * `loams.instance.getInstance` needs anyway.
+     */
+    auth?: TokenSource | string;
+    /**
+     * The transport. Defaults to Connect over `fetch` pointed at `endpoint`,
+     * which is the browser, Node, Deno and Bun path (see `runtime/transports.ts`).
+     * `@loams/client/node` exports `createNodeTransport` for HTTP/2 gRPC.
+     *
+     * A transport carries its own base URL, so a transport passed here must be
+     * built for the same instance as `endpoint`.
+     */
+    transport?: Transport;
+    /** Transport-level options, used when `transport` is not given. They win
+     * over `endpoint` where they overlap, so `baseUrl` here replaces it. */
+    transportOptions?: TransportOptions;
+    /** Retries after the first attempt, for every call. `0` disables them. */
+    maxRetries?: number;
+    /**
+     * Hold a session consistency token across calls (D609). Off by default:
+     * every read is then `STRONG` on its own, which is correct but does not give
+     * read-your-writes across processes.
+     */
+    sessionConsistency?: boolean;
+    /** The client's deadline, when the transport does not set one. */
+    timeoutMs?: number;
+}
+export type { Catalogue, VersionReport } from './system.js';
+/** The generated modules, keyed by name. A module the generator has not seen
+ * does not appear, so `loams.vector` is absent until `QueryService/Search`
+ * carries its facade options (API1 Task 2). */
+export interface LoamsModules {
+    readonly instance: InstanceModule;
+    readonly live: LiveModule;
+    readonly tables: TablesModule;
+    readonly [module: string]: unknown;
+}
+/** `loams.live`: the session calls, with `loams.live.admin` under it. */
+export type LiveNamespace = LiveModule & {
+    /** `loams.live.admin` — apps, deploy, roll back, index status and logs. */
+    readonly admin: LiveAdminModule;
+};
+/** `loams.admin`: the console's administration modules (design §44 §7.2). */
+export interface AdminNamespace {
+    readonly agents: AdminAgentsModule;
+    readonly audit: AdminAuditModule;
+    readonly keys: AdminKeysModule;
+    readonly org: AdminOrgModule;
+    readonly projects: AdminProjectsModule;
+}
+/** One SDK, over one instance. */
+export declare class Loams {
+    #private;
+    /** `loams.instance` — what this instance is, and who the caller is. */
+    readonly instance: InstanceModule;
+    /** `loams.live` — the live sync session half, and `loams.live.admin`.
+     * Its package is `unstable`. */
+    readonly live: LiveNamespace;
+    /** `loams.tables` — the table half of the same service (design §44 §7.2). */
+    readonly tables: TablesModule;
+    /** `loams.admin` — org, projects, agents, keys and audit. */
+    readonly admin: AdminNamespace;
+    /** `loams.auth` — sessions and sign-in. */
+    readonly auth: AuthModule;
+    /** The module catalogue, feature detection and the version check. */
+    readonly system: SystemApi;
+    /** Every generated module, by its dotted name (`'live.admin'`): the
+     * catalogue a caller iterates. The same objects are reachable as
+     * properties, `loams.live.admin` for `'live.admin'`. */
+    readonly modules: Readonly<Record<string, unknown>>;
+    constructor(options: LoamsOptions);
+    /** The session consistency token store, when `sessionConsistency` is on. */
+    get consistency(): ConsistencyTokenStore | undefined;
+    /** The generated module bindings, as the SDK sees them. */
+    get bindings(): readonly ModuleBinding[];
+    /** Every item of a paged call (D617's iterator).
+     *
+     * `loams.paginate('collections', 'listCollections', { namespace })`. The
+     * per-call alias §44 §7.4 sketches (`loams.collections.listAll`) arrives with
+     * the first paged RPC, when there is a generated signature to hang it on;
+     * until then this is the same iterator under its module and call name.
+     */
+    paginate<Request extends object, Response extends object, Item>(module: string, call: string, request: Request, options?: CallOptions & PageRequestOptions): AsyncGenerator<Item, void, undefined>;
+    /** A server stream that reconnects from its cursor (runtime contract R7). */
+    stream<Message, Request extends object>(module: string, call: string, request: Request, options: CallOptions & ResumeOptions<Message, Request>): AsyncGenerator<Message, void, undefined>;
+    /** The binding a module and call name identify, or a clear error. */
+    binding(module: string, call: string): CallBinding;
+    /** The proto revision this SDK declares (§44 §10.3). */
+    get protoRev(): string;
+    /** The proto packages this SDK speaks. */
+    get protoPackages(): readonly string[];
+    /** Forgets the cached service catalogue, so the next check calls again. */
+    invalidateCatalogue(): void;
+}