@authoric/js 0.0.0-stage → 0.1.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 (101) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +94 -3
  3. package/bin/authoric.mjs +345 -0
  4. package/dist/cjs/app-actions.js +40 -0
  5. package/dist/cjs/app-actions.js.map +1 -0
  6. package/dist/cjs/auth.js +335 -0
  7. package/dist/cjs/auth.js.map +1 -0
  8. package/dist/cjs/client.js +121 -0
  9. package/dist/cjs/client.js.map +1 -0
  10. package/dist/cjs/cookies.js +137 -0
  11. package/dist/cjs/cookies.js.map +1 -0
  12. package/dist/cjs/data.js +197 -0
  13. package/dist/cjs/data.js.map +1 -0
  14. package/dist/cjs/errors.js +70 -0
  15. package/dist/cjs/errors.js.map +1 -0
  16. package/dist/cjs/files.js +188 -0
  17. package/dist/cjs/files.js.map +1 -0
  18. package/dist/cjs/generated/error-codes.js +435 -0
  19. package/dist/cjs/generated/error-codes.js.map +1 -0
  20. package/dist/cjs/index.js +31 -0
  21. package/dist/cjs/index.js.map +1 -0
  22. package/dist/cjs/package.json +3 -0
  23. package/dist/cjs/realtime.js +191 -0
  24. package/dist/cjs/realtime.js.map +1 -0
  25. package/dist/cjs/routes.js +113 -0
  26. package/dist/cjs/routes.js.map +1 -0
  27. package/dist/cjs/session.js +430 -0
  28. package/dist/cjs/session.js.map +1 -0
  29. package/dist/cjs/storage-adapters.js +83 -0
  30. package/dist/cjs/storage-adapters.js.map +1 -0
  31. package/dist/cjs/teams.js +152 -0
  32. package/dist/cjs/teams.js.map +1 -0
  33. package/dist/cjs/transport.js +189 -0
  34. package/dist/cjs/transport.js.map +1 -0
  35. package/dist/cjs/types.js +7 -0
  36. package/dist/cjs/types.js.map +1 -0
  37. package/dist/esm/app-actions.d.ts +32 -0
  38. package/dist/esm/app-actions.d.ts.map +1 -0
  39. package/dist/esm/app-actions.js +37 -0
  40. package/dist/esm/app-actions.js.map +1 -0
  41. package/dist/esm/auth.d.ts +259 -0
  42. package/dist/esm/auth.d.ts.map +1 -0
  43. package/dist/esm/auth.js +331 -0
  44. package/dist/esm/auth.js.map +1 -0
  45. package/dist/esm/client.d.ts +82 -0
  46. package/dist/esm/client.d.ts.map +1 -0
  47. package/dist/esm/client.js +115 -0
  48. package/dist/esm/client.js.map +1 -0
  49. package/dist/esm/cookies.d.ts +66 -0
  50. package/dist/esm/cookies.d.ts.map +1 -0
  51. package/dist/esm/cookies.js +129 -0
  52. package/dist/esm/cookies.js.map +1 -0
  53. package/dist/esm/data.d.ts +211 -0
  54. package/dist/esm/data.d.ts.map +1 -0
  55. package/dist/esm/data.js +191 -0
  56. package/dist/esm/data.js.map +1 -0
  57. package/dist/esm/errors.d.ts +61 -0
  58. package/dist/esm/errors.d.ts.map +1 -0
  59. package/dist/esm/errors.js +63 -0
  60. package/dist/esm/errors.js.map +1 -0
  61. package/dist/esm/files.d.ts +76 -0
  62. package/dist/esm/files.d.ts.map +1 -0
  63. package/dist/esm/files.js +184 -0
  64. package/dist/esm/files.js.map +1 -0
  65. package/dist/esm/generated/error-codes.d.ts +5 -0
  66. package/dist/esm/generated/error-codes.d.ts.map +1 -0
  67. package/dist/esm/generated/error-codes.js +432 -0
  68. package/dist/esm/generated/error-codes.js.map +1 -0
  69. package/dist/esm/index.d.ts +22 -0
  70. package/dist/esm/index.d.ts.map +1 -0
  71. package/dist/esm/index.js +9 -0
  72. package/dist/esm/index.js.map +1 -0
  73. package/dist/esm/realtime.d.ts +33 -0
  74. package/dist/esm/realtime.d.ts.map +1 -0
  75. package/dist/esm/realtime.js +186 -0
  76. package/dist/esm/realtime.js.map +1 -0
  77. package/dist/esm/routes.d.ts +75 -0
  78. package/dist/esm/routes.d.ts.map +1 -0
  79. package/dist/esm/routes.js +108 -0
  80. package/dist/esm/routes.js.map +1 -0
  81. package/dist/esm/session.d.ts +99 -0
  82. package/dist/esm/session.d.ts.map +1 -0
  83. package/dist/esm/session.js +425 -0
  84. package/dist/esm/session.js.map +1 -0
  85. package/dist/esm/storage-adapters.d.ts +31 -0
  86. package/dist/esm/storage-adapters.d.ts.map +1 -0
  87. package/dist/esm/storage-adapters.js +76 -0
  88. package/dist/esm/storage-adapters.js.map +1 -0
  89. package/dist/esm/teams.d.ts +157 -0
  90. package/dist/esm/teams.d.ts.map +1 -0
  91. package/dist/esm/teams.js +146 -0
  92. package/dist/esm/teams.js.map +1 -0
  93. package/dist/esm/transport.d.ts +56 -0
  94. package/dist/esm/transport.d.ts.map +1 -0
  95. package/dist/esm/transport.js +185 -0
  96. package/dist/esm/transport.js.map +1 -0
  97. package/dist/esm/types.d.ts +203 -0
  98. package/dist/esm/types.d.ts.map +1 -0
  99. package/dist/esm/types.js +6 -0
  100. package/dist/esm/types.js.map +1 -0
  101. package/package.json +54 -6
@@ -0,0 +1,83 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.resolveStorage = exports.sessionStorageAdapter = exports.localStorageAdapter = exports.memoryStorage = void 0;
4
+ /** Nothing persists: a reload signs the user out. The default outside a browser. */
5
+ const memoryStorage = () => {
6
+ const values = new Map();
7
+ return {
8
+ getItem: (key) => values.get(key) ?? null,
9
+ setItem: (key, value) => {
10
+ values.set(key, value);
11
+ },
12
+ removeItem: (key) => {
13
+ values.delete(key);
14
+ },
15
+ };
16
+ };
17
+ exports.memoryStorage = memoryStorage;
18
+ // A Web Storage object may exist and still throw on use (Safari private mode, storage disabled, a
19
+ // sandboxed iframe), so every call is guarded, and a failure degrades to "not persisted".
20
+ const webStorage = (pick) => {
21
+ const store = () => {
22
+ try {
23
+ return pick();
24
+ }
25
+ catch {
26
+ return undefined;
27
+ }
28
+ };
29
+ return {
30
+ getItem: (key) => {
31
+ try {
32
+ return store()?.getItem(key) ?? null;
33
+ }
34
+ catch {
35
+ return null;
36
+ }
37
+ },
38
+ setItem: (key, value) => {
39
+ try {
40
+ store()?.setItem(key, value);
41
+ }
42
+ catch {
43
+ // Not persisted; the session still works until the page closes.
44
+ }
45
+ },
46
+ removeItem: (key) => {
47
+ try {
48
+ store()?.removeItem(key);
49
+ }
50
+ catch {
51
+ // Nothing to remove.
52
+ }
53
+ },
54
+ };
55
+ };
56
+ /**
57
+ * `window.localStorage`: the session survives reloads and is shared by the tabs of one origin. The
58
+ * default in a browser.
59
+ *
60
+ * The tradeoff, stated plainly: script running on the page (an XSS bug in the app) can read it. That
61
+ * is true of every single-page app that holds a bearer token. Refresh tokens are single-use, so when a
62
+ * stolen one and the real one are both used, the server ends the session for both.
63
+ */
64
+ const localStorageAdapter = () => webStorage(() => (typeof localStorage === "undefined" ? undefined : localStorage));
65
+ exports.localStorageAdapter = localStorageAdapter;
66
+ /** `window.sessionStorage`: survives reloads of ONE tab, and is gone when the tab closes. */
67
+ const sessionStorageAdapter = () => webStorage(() => (typeof sessionStorage === "undefined" ? undefined : sessionStorage));
68
+ exports.sessionStorageAdapter = sessionStorageAdapter;
69
+ const resolveStorage = (option) => {
70
+ if (option && typeof option === "object")
71
+ return option;
72
+ const inBrowser = typeof window !== "undefined" && typeof document !== "undefined";
73
+ switch (option ?? (inBrowser ? "local" : "memory")) {
74
+ case "local":
75
+ return (0, exports.localStorageAdapter)();
76
+ case "session":
77
+ return (0, exports.sessionStorageAdapter)();
78
+ default:
79
+ return (0, exports.memoryStorage)();
80
+ }
81
+ };
82
+ exports.resolveStorage = resolveStorage;
83
+ //# sourceMappingURL=storage-adapters.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"storage-adapters.js","sourceRoot":"","sources":["../../src/storage-adapters.ts"],"names":[],"mappings":";;;AAgBA,oFAAoF;AAC7E,MAAM,aAAa,GAAG,GAA0B,EAAE;IACxD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,OAAO;QACN,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI;QACzC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE;YACnB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;KACD,CAAC;AACH,CAAC,CAAC;AAXW,QAAA,aAAa,iBAWxB;AAEF,kGAAkG;AAClG,0FAA0F;AAC1F,MAAM,UAAU,GAAG,CAAC,IAA+B,EAAyB,EAAE;IAC7E,MAAM,KAAK,GAAG,GAAG,EAAE;QAClB,IAAI,CAAC;YACJ,OAAO,IAAI,EAAE,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC,CAAC;IACF,OAAO;QACN,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAChB,IAAI,CAAC;gBACJ,OAAO,KAAK,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACR,OAAO,IAAI,CAAC;YACb,CAAC;QACF,CAAC;QACD,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YACvB,IAAI,CAAC;gBACJ,KAAK,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACR,gEAAgE;YACjE,CAAC;QACF,CAAC;QACD,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE;YACnB,IAAI,CAAC;gBACJ,KAAK,EAAE,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACR,qBAAqB;YACtB,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;GAOG;AACI,MAAM,mBAAmB,GAAG,GAA0B,EAAE,CAC9D,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,YAAY,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;AADvE,QAAA,mBAAmB,uBACoD;AAEpF,6FAA6F;AACtF,MAAM,qBAAqB,GAAG,GAA0B,EAAE,CAChE,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,cAAc,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;AAD3E,QAAA,qBAAqB,yBACsD;AAIjF,MAAM,cAAc,GAAG,CAAC,MAAiC,EAAyB,EAAE;IAC1F,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IACxD,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,CAAC;IACnF,QAAQ,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,KAAK,OAAO;YACX,OAAO,IAAA,2BAAmB,GAAE,CAAC;QAC9B,KAAK,SAAS;YACb,OAAO,IAAA,6BAAqB,GAAE,CAAC;QAChC;YACC,OAAO,IAAA,qBAAa,GAAE,CAAC;IACzB,CAAC;AACF,CAAC,CAAC;AAXW,QAAA,cAAc,kBAWzB"}
@@ -0,0 +1,152 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.BillingClient = exports.RolesClient = exports.OrgsClient = void 0;
4
+ // Teams, roles and billing (notes/client-sdk-plan.md §2.4): typed methods over the API's seeded
5
+ // actions (./app-actions.ts). The server decides everything, as always: who may invite, the role
6
+ // ceiling ("you may only grant what you hold"), what a user may buy. The SDK adds no rule of its own.
7
+ const errors_js_1 = require("./errors.js");
8
+ const app_actions_js_1 = require("./app-actions.js");
9
+ const routes_js_1 = require("./routes.js");
10
+ const call = (transport, name, options = {}) => {
11
+ const spec = app_actions_js_1.APP_ACTIONS[name];
12
+ for (const [key, value] of Object.entries(options.params ?? {})) {
13
+ if (typeof value !== "string" || !value)
14
+ throw (0, errors_js_1.clientError)("AUTHORIC_INVALID_ARGUMENT", `Missing ${key}.`);
15
+ }
16
+ // The table and the action's own path are constants from APP_ACTIONS; every caller-supplied value
17
+ // goes through fillPath, which encodes it as exactly ONE segment (a "/" cannot add one, ".." is
18
+ // refused), so no value can steer the request to another action.
19
+ const route = {
20
+ method: spec.method,
21
+ path: `${(0, routes_js_1.fillPath)("/autocrud/:table", { table: spec.table })}${(0, routes_js_1.fillPath)(spec.path, options.params ?? {})}`,
22
+ };
23
+ return transport.request(route, {
24
+ body: spec.method === "GET" ? undefined : (options.body ?? {}),
25
+ query: options.query,
26
+ auth: options.anonymous ? "optional" : "required",
27
+ });
28
+ };
29
+ /** The user's organizations: theirs, the ones they joined, and the active one's people. */
30
+ class OrgsClient {
31
+ constructor(transport, session) {
32
+ this.transport = transport;
33
+ this.session = session;
34
+ /** The active org's members. */
35
+ this.members = {
36
+ list: (input = {}) => call(this.transport, "members", { query: input }),
37
+ /** Remove someone else from the active org. */
38
+ remove: (input) => call(this.transport, "removeMember", { body: input }),
39
+ /** Leave the active org (not the user's own). */
40
+ leave: () => call(this.transport, "leaveOrg"),
41
+ };
42
+ /** Invitations into the active org, and the ones addressed to the user. */
43
+ this.invitations = {
44
+ /** Invite someone to the active org by email. The app sends them its invitation email. */
45
+ send: (input) => call(this.transport, "invite", { body: input }),
46
+ sent: (input = {}) => call(this.transport, "invitesSent", { query: input }),
47
+ received: (input = {}) => call(this.transport, "invitesReceived", { query: input }),
48
+ accept: (input) => call(this.transport, "inviteAccept", { body: input }),
49
+ deny: (input) => call(this.transport, "inviteDeny", { body: input }),
50
+ /** Withdraw an invitation addressed to the user. */
51
+ cancel: (input) => call(this.transport, "inviteCancel", { body: input }),
52
+ /** Withdraw an invitation the active org sent. */
53
+ revoke: (input) => call(this.transport, "inviteRevoke", { body: input }),
54
+ };
55
+ }
56
+ /** Every org the user belongs to, the active one flagged. */
57
+ list() {
58
+ return call(this.transport, "myOrgs");
59
+ }
60
+ /** Act in another of the user's orgs (the same as `auth.switchOrg`). */
61
+ async switch(orgUid) {
62
+ if (!orgUid)
63
+ throw (0, errors_js_1.clientError)("AUTHORIC_INVALID_ARGUMENT", "switch needs the org's uid.");
64
+ const session = await this.session.refresh({ activeOrgUid: orgUid });
65
+ if (!session)
66
+ throw (0, errors_js_1.clientError)("AUTHORIC_NOT_SIGNED_IN", "Sign in first.");
67
+ return session;
68
+ }
69
+ /**
70
+ * Create an organization beyond the user's own, which they then own. Only where the app's owner
71
+ * allows it (`ORG_CREATION_DISABLED` otherwise), up to its limit (`ORG_LIMIT_REACHED`).
72
+ */
73
+ create(input) {
74
+ return call(this.transport, "createOrg", { body: input });
75
+ }
76
+ /** Rename the active org. */
77
+ rename(input) {
78
+ return call(this.transport, "renameOrg", { body: input });
79
+ }
80
+ }
81
+ exports.OrgsClient = OrgsClient;
82
+ /** Roles in the user's org: what exists, who holds what, and granting within what the caller holds. */
83
+ class RolesClient {
84
+ constructor(transport) {
85
+ this.transport = transport;
86
+ }
87
+ /** The roles of the active org. */
88
+ list(input = {}) {
89
+ return this.transport.request(routes_js_1.ROUTES.rowsList, { params: { table: "roles" }, query: input });
90
+ }
91
+ /** The roles one user holds. */
92
+ forUser(userUid) {
93
+ return call(this.transport, "userRoles", { params: { userUid } });
94
+ }
95
+ async change(name, target) {
96
+ const body = {
97
+ user_uid: target.userUid,
98
+ ...(target.roleUid ? { role_uid: target.roleUid } : { role_key: target.roleKey }),
99
+ ...(target.orgUid ? { target_org_uid: target.orgUid } : {}),
100
+ };
101
+ // The server answers a review first (what changes, and a hash of it), then applies exactly that.
102
+ const review = await call(this.transport, name, { body: { ...body, mode: "review" } });
103
+ if (!review?.reviewHash)
104
+ throw (0, errors_js_1.clientError)("AUTHORIC_BAD_RESPONSE", "The role change answered no review.");
105
+ return call(this.transport, name, { body: { ...body, mode: "confirm", reviewHash: review.reviewHash } });
106
+ }
107
+ /** Give a user a role. The server refuses a role carrying more than the caller holds. */
108
+ assign(target) {
109
+ return this.change("bindRole", target);
110
+ }
111
+ /** Take a role away from a user. */
112
+ unassign(target) {
113
+ return this.change("unbindRole", target);
114
+ }
115
+ }
116
+ exports.RolesClient = RolesClient;
117
+ /** Buying the app's products, through the app owner's own Stripe account. */
118
+ class BillingClient {
119
+ constructor(transport) {
120
+ this.transport = transport;
121
+ }
122
+ /** The app's active products and prices, for a pricing page. Works signed out. */
123
+ catalog() {
124
+ return call(this.transport, "catalog", { anonymous: true });
125
+ }
126
+ /** Start a subscription to a recurring price. Answers the client secret Stripe's payment form confirms. */
127
+ subscribe(input) {
128
+ return call(this.transport, "subscribe", { body: input });
129
+ }
130
+ /** A one-time purchase. Answers the client secret Stripe's payment form confirms. */
131
+ order(input) {
132
+ return call(this.transport, "order", { body: input });
133
+ }
134
+ /** The user's subscriptions. */
135
+ subscriptions() {
136
+ return call(this.transport, "subscriptions");
137
+ }
138
+ /** Cancel at the end of the period. */
139
+ cancel(subscriptionUid) {
140
+ return call(this.transport, "cancelSubscription", { params: { subscriptionUid } });
141
+ }
142
+ /** Undo a pending cancellation. */
143
+ resume(subscriptionUid) {
144
+ return call(this.transport, "resumeSubscription", { params: { subscriptionUid } });
145
+ }
146
+ /** What the user's purchases entitle them to (limits and features). */
147
+ entitlements() {
148
+ return call(this.transport, "entitlements");
149
+ }
150
+ }
151
+ exports.BillingClient = BillingClient;
152
+ //# sourceMappingURL=teams.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"teams.js","sourceRoot":"","sources":["../../src/teams.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,189 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Transport = void 0;
4
+ // Every request the SDK makes goes through here. One place builds the URL, attaches the user's token,
5
+ // refreshes it once when the server says it expired, honors Retry-After, and turns a refusal into an
6
+ // AuthoricError.
7
+ //
8
+ // What it never does (notes/client-sdk-plan.md, "Things the SDK must never do"):
9
+ // - send the Authorization header anywhere but the configured API (a presigned PUT, a file link and
10
+ // an OAuth redirect are fetched by their callers without it);
11
+ // - retry a write that carries no Idempotency-Key;
12
+ // - retry after SESSION_ENDED, or after any 4xx other than one refresh on an expired token;
13
+ // - log a header, a body, a token or a query value.
14
+ const errors_js_1 = require("./errors.js");
15
+ const routes_js_1 = require("./routes.js");
16
+ const WAIT_CODES = new Set(["APP_WAKING", "APP_RESTORING", "RATE_LIMITED"]);
17
+ const parseRetryAfter = (value, now = Date.now()) => {
18
+ if (!value)
19
+ return null;
20
+ const seconds = Number(value);
21
+ if (Number.isFinite(seconds) && seconds >= 0)
22
+ return seconds;
23
+ const at = Date.parse(value);
24
+ return Number.isFinite(at) ? Math.max(0, Math.ceil((at - now) / 1000)) : null;
25
+ };
26
+ const sleep = (ms, signal) => new Promise((resolve, reject) => {
27
+ if (signal?.aborted) {
28
+ reject(signal.reason ?? new Error("Aborted"));
29
+ return;
30
+ }
31
+ const timer = setTimeout(() => {
32
+ signal?.removeEventListener("abort", onAbort);
33
+ resolve();
34
+ }, ms);
35
+ const onAbort = () => {
36
+ clearTimeout(timer);
37
+ reject(signal?.reason ?? new Error("Aborted"));
38
+ };
39
+ signal?.addEventListener("abort", onAbort, { once: true });
40
+ });
41
+ const isAbort = (error) => error instanceof Error && (error.name === "AbortError" || error.name === "TimeoutError");
42
+ class Transport {
43
+ constructor(config) {
44
+ this.tokens = null;
45
+ this.config = config;
46
+ }
47
+ setTokenSource(tokens) {
48
+ this.tokens = tokens;
49
+ }
50
+ /** The absolute URL of an app route. */
51
+ url(route, params, query) {
52
+ const search = new URLSearchParams();
53
+ for (const [key, value] of Object.entries(query ?? {})) {
54
+ if (value === undefined || value === null)
55
+ continue;
56
+ search.append(key, String(value));
57
+ }
58
+ const qs = search.toString();
59
+ return `${this.config.baseUrl}/${encodeURIComponent(this.config.appUid)}${(0, routes_js_1.fillPath)(route.path, params)}${qs ? `?${qs}` : ""}`;
60
+ }
61
+ async request(route, options = {}) {
62
+ const auth = options.auth ?? "required";
63
+ const method = route.method;
64
+ // Safe to send twice: a read, or a write the server will recognize by its key.
65
+ const retrySafe = method === "GET" || Boolean(options.idempotencyKey);
66
+ const url = this.url(route, options.params, options.query);
67
+ let refreshed = false;
68
+ let waited = false;
69
+ for (let attempt = 1;; attempt += 1) {
70
+ const headers = {
71
+ Accept: options.accept ?? "application/json",
72
+ ...(options.headers ?? {}),
73
+ };
74
+ let body;
75
+ if (options.formData) {
76
+ body = options.formData;
77
+ }
78
+ else if (options.body !== undefined) {
79
+ headers["Content-Type"] = "application/json";
80
+ body = JSON.stringify(options.body);
81
+ }
82
+ if (options.idempotencyKey)
83
+ headers["Idempotency-Key"] = options.idempotencyKey;
84
+ let token = null;
85
+ if (auth !== "none") {
86
+ token = this.tokens ? await this.tokens.getAccessToken() : null;
87
+ if (!token && auth === "required") {
88
+ throw (0, errors_js_1.clientError)("AUTHORIC_NOT_SIGNED_IN", "Sign in first: this call acts as a signed-in user.");
89
+ }
90
+ if (token)
91
+ headers.Authorization = `Bearer ${token}`;
92
+ }
93
+ const started = Date.now();
94
+ let response;
95
+ try {
96
+ response = await this.config.fetch(url, {
97
+ method,
98
+ headers,
99
+ body,
100
+ signal: options.signal,
101
+ // Never ambient credentials: the API authenticates by bearer token alone.
102
+ credentials: "omit",
103
+ });
104
+ }
105
+ catch (error) {
106
+ if (isAbort(error) || options.signal?.aborted)
107
+ throw error;
108
+ this.log({ method, route: route.path, status: null, code: null, durationMs: Date.now() - started, requestId: null, attempt });
109
+ throw (0, errors_js_1.clientError)("AUTHORIC_NETWORK_ERROR", "The request did not reach Authoric (offline, or blocked).", error);
110
+ }
111
+ if (response.ok) {
112
+ this.log({ method, route: route.path, status: response.status, code: null, durationMs: Date.now() - started, requestId: null, attempt });
113
+ return (await this.read(response, options.responseType ?? "json"));
114
+ }
115
+ const errorBody = await response
116
+ .clone()
117
+ .json()
118
+ .catch(() => null);
119
+ const retryAfter = parseRetryAfter(response.headers.get("Retry-After"));
120
+ const error = (0, errors_js_1.errorFromResponse)(response.status, errorBody, retryAfter);
121
+ this.log({ method, route: route.path, status: response.status, code: error.code, durationMs: Date.now() - started, requestId: error.requestId, attempt });
122
+ // An expired access token: refresh ONCE, then send the same request again.
123
+ if (response.status === 401 &&
124
+ token &&
125
+ !refreshed &&
126
+ this.tokens &&
127
+ (error.code === "AUTH_TOKEN_EXPIRED" || error.code === "AUTH_TOKEN_INVALID")) {
128
+ refreshed = true;
129
+ const session = await this.tokens.refresh({ force: true });
130
+ if (session)
131
+ continue;
132
+ throw error;
133
+ }
134
+ // The session is over on the server: forget it here too, and stop.
135
+ if (error.code === "SESSION_ENDED" && token && this.tokens) {
136
+ const reason = error.details?.reason;
137
+ await this.tokens.end(reason ?? "ended");
138
+ throw error;
139
+ }
140
+ // The server asked for a wait: once, within the cap, and only when sending again is safe.
141
+ const waitSeconds = error.retryAfterSeconds;
142
+ if (!waited &&
143
+ retrySafe &&
144
+ waitSeconds != null &&
145
+ (WAIT_CODES.has(String(error.code)) || response.status === 429 || response.status === 503) &&
146
+ waitSeconds * 1000 <= this.config.maxRetryWaitMs) {
147
+ waited = true;
148
+ await sleep(waitSeconds * 1000, options.signal);
149
+ continue;
150
+ }
151
+ throw error;
152
+ }
153
+ }
154
+ async read(response, type) {
155
+ if (type === "response")
156
+ return response;
157
+ if (type === "blob")
158
+ return response.blob();
159
+ if (type === "arrayBuffer")
160
+ return response.arrayBuffer();
161
+ if (response.status === 204)
162
+ return null;
163
+ const text = await response.text();
164
+ if (!text)
165
+ return null;
166
+ try {
167
+ return JSON.parse(text);
168
+ }
169
+ catch (cause) {
170
+ throw new errors_js_1.AuthoricError("The server answered with something that is not JSON.", {
171
+ code: "AUTHORIC_BAD_RESPONSE",
172
+ status: response.status,
173
+ cause,
174
+ });
175
+ }
176
+ }
177
+ log(event) {
178
+ if (!this.config.debug)
179
+ return;
180
+ try {
181
+ this.config.debug(event);
182
+ }
183
+ catch {
184
+ // A logger's bug must not fail the request.
185
+ }
186
+ }
187
+ }
188
+ exports.Transport = Transport;
189
+ //# sourceMappingURL=transport.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/transport.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ "use strict";
2
+ // The shapes the API answers with, as the client SDK presents them.
3
+ //
4
+ // Records are named by `uid` everywhere; the API never returns a numeric `id`, and nothing here
5
+ // invents one. Timestamps are ISO strings, as the API sends them.
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA,oEAAoE;AACpE,EAAE;AACF,gGAAgG;AAChG,kEAAkE"}
@@ -0,0 +1,32 @@
1
+ export interface AppAction {
2
+ readonly table: string;
3
+ readonly method: "GET" | "POST";
4
+ readonly path: string;
5
+ }
6
+ export declare const APP_ACTIONS: Readonly<{
7
+ myOrgs: AppAction;
8
+ members: AppAction;
9
+ removeMember: AppAction;
10
+ leaveOrg: AppAction;
11
+ renameOrg: AppAction;
12
+ createOrg: AppAction;
13
+ invite: AppAction;
14
+ invitesSent: AppAction;
15
+ invitesReceived: AppAction;
16
+ inviteAccept: AppAction;
17
+ inviteDeny: AppAction;
18
+ inviteCancel: AppAction;
19
+ inviteRevoke: AppAction;
20
+ userRoles: AppAction;
21
+ bindRole: AppAction;
22
+ unbindRole: AppAction;
23
+ catalog: AppAction;
24
+ subscribe: AppAction;
25
+ order: AppAction;
26
+ subscriptions: AppAction;
27
+ cancelSubscription: AppAction;
28
+ resumeSubscription: AppAction;
29
+ entitlements: AppAction;
30
+ }>;
31
+ export type AppActionName = keyof typeof APP_ACTIONS;
32
+ //# sourceMappingURL=app-actions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"app-actions.d.ts","sourceRoot":"","sources":["../../src/app-actions.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAID,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;EA6BtB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,WAAW,CAAC"}
@@ -0,0 +1,37 @@
1
+ // Every seeded table ACTION the client SDK calls (teams, roles, billing), in ONE table.
2
+ //
3
+ // These are `table_meta.config.actions` descriptors seeded by the API's migration 001, served under
4
+ // `/autocrud/:table/actions/...`. The backend suite reads this file
5
+ // (api/tests/clientSdkActions.parity.test.js) and checks each entry against 001's descriptors, with
6
+ // the same method, so a renamed or withdrawn action fails there instead of in a customer's app.
7
+ // A `:name` segment is filled, URL-encoded, by the caller.
8
+ const action = (table, method, path) => Object.freeze({ table, method, path });
9
+ export const APP_ACTIONS = Object.freeze({
10
+ // ── Teams ────────────────────────────────────────────────────────────────────────────────────
11
+ myOrgs: action("org_memberships", "GET", "/actions/my-orgs"),
12
+ members: action("org_memberships", "GET", "/actions"),
13
+ removeMember: action("org_memberships", "POST", "/actions/org-memberships/remove"),
14
+ leaveOrg: action("org_memberships", "POST", "/actions/org-memberships/leave"),
15
+ renameOrg: action("orgs", "POST", "/actions/rename-active"),
16
+ createOrg: action("orgs", "POST", "/actions/create"),
17
+ invite: action("org_invitations", "POST", "/actions/org-invites"),
18
+ invitesSent: action("org_invitations", "GET", "/actions/org-invites/sent"),
19
+ invitesReceived: action("org_invitations", "GET", "/actions/org-invites/received"),
20
+ inviteAccept: action("org_invitations", "POST", "/actions/org-invites/accept"),
21
+ inviteDeny: action("org_invitations", "POST", "/actions/org-invites/deny"),
22
+ inviteCancel: action("org_invitations", "POST", "/actions/org-invites/cancel"),
23
+ inviteRevoke: action("org_invitations", "POST", "/actions/org-invites/revoke"),
24
+ // ── Roles ────────────────────────────────────────────────────────────────────────────────────
25
+ userRoles: action("users", "GET", "/actions/:userUid/roles"),
26
+ bindRole: action("users", "POST", "/actions/bind-role"),
27
+ unbindRole: action("users", "POST", "/actions/unbind-role"),
28
+ // ── Billing ──────────────────────────────────────────────────────────────────────────────────
29
+ catalog: action("products", "GET", "/actions/catalog"),
30
+ subscribe: action("products", "POST", "/actions/subscribe"),
31
+ order: action("products", "POST", "/actions/order"),
32
+ subscriptions: action("user_subscriptions", "GET", "/actions/subscriptions"),
33
+ cancelSubscription: action("user_subscriptions", "POST", "/actions/:subscriptionUid/cancel"),
34
+ resumeSubscription: action("user_subscriptions", "POST", "/actions/:subscriptionUid/resume"),
35
+ entitlements: action("user_subscriptions", "GET", "/actions/entitlements"),
36
+ });
37
+ //# sourceMappingURL=app-actions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"app-actions.js","sourceRoot":"","sources":["../../src/app-actions.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,EAAE;AACF,oGAAoG;AACpG,oEAAoE;AACpE,oGAAoG;AACpG,gGAAgG;AAChG,2DAA2D;AAQ3D,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,MAA2B,EAAE,IAAY,EAAa,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAE/H,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,gGAAgG;IAChG,MAAM,EAAE,MAAM,CAAC,iBAAiB,EAAE,KAAK,EAAE,kBAAkB,CAAC;IAC5D,OAAO,EAAE,MAAM,CAAC,iBAAiB,EAAE,KAAK,EAAE,UAAU,CAAC;IACrD,YAAY,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,iCAAiC,CAAC;IAClF,QAAQ,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,gCAAgC,CAAC;IAC7E,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,wBAAwB,CAAC;IAC3D,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC;IACpD,MAAM,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,sBAAsB,CAAC;IACjE,WAAW,EAAE,MAAM,CAAC,iBAAiB,EAAE,KAAK,EAAE,2BAA2B,CAAC;IAC1E,eAAe,EAAE,MAAM,CAAC,iBAAiB,EAAE,KAAK,EAAE,+BAA+B,CAAC;IAClF,YAAY,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,6BAA6B,CAAC;IAC9E,UAAU,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,2BAA2B,CAAC;IAC1E,YAAY,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,6BAA6B,CAAC;IAC9E,YAAY,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,EAAE,6BAA6B,CAAC;IAE9E,gGAAgG;IAChG,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,yBAAyB,CAAC;IAC5D,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,oBAAoB,CAAC;IACvD,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,sBAAsB,CAAC;IAE3D,gGAAgG;IAChG,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,kBAAkB,CAAC;IACtD,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,oBAAoB,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,CAAC;IACnD,aAAa,EAAE,MAAM,CAAC,oBAAoB,EAAE,KAAK,EAAE,wBAAwB,CAAC;IAC5E,kBAAkB,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,EAAE,kCAAkC,CAAC;IAC5F,kBAAkB,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,EAAE,kCAAkC,CAAC;IAC5F,YAAY,EAAE,MAAM,CAAC,oBAAoB,EAAE,KAAK,EAAE,uBAAuB,CAAC;CAC1E,CAAC,CAAC"}